This document covers the following topics:
An open result view.
The following properties are available:
Used to navigate to the parent interface of this interface.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| HANDLE OF OBJECT | VT_DISPATCH (INatAutoResultViews) | Get only |
Used to navigate to the root interface.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| HANDLE OF OBJECT | VT_DISPATCH (INatAutoStudio) | Get only |
Indicates if this result view is currently the active one or not. Setting Active to TRUE makes the result view the active one. Setting Active to FALSE has no effect.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| L | VT_BOOL |
The following methods are available:
Inserts a number of rows at the end of the result view. Each row is
displayed in the result view as a node with attributes. Before referring to a
node type in this method, the plug-in must have registered the node type
through the interface INatAutoNodeTypes.
To avoid flickering, the result view is not redrawn after each call to
InsertRows. After a series of calls to
InsertRows the method Update
should be called to redraw the result view.
| Name | Natural Data Format | Variant Type | Remark |
|---|---|---|---|
| Return value | I4 | VT_I4) | |
| Rows | A | VT_BSTR |
The number of rows contained in the result view after the insertion.
Contains an XML document that describes the rows to be inserted. The XML document is structured according to the following DTD.
<!ELEMENT rows (row*)> <!ELEMENT row (pitem, attributevalues?)> <!ELEMENT pitem (pguid?, ptype, pkey, pinfo?, pname?, (ntype, nkey)?)> <!ELEMENT pguid (#PCDATA)> <!ELEMENT ptype (#PCDATA)> <!ELEMENT pkey (#PCDATA)> <!ELEMENT pinfo (#PCDATA)> <!ELEMENT pname (#PCDATA)> <!ELEMENT ntype (#PCDATA)> <!ELEMENT nkey (#PCDATA)> <!ELEMENT attributevalues (attval*)> <!ELEMENT attval (akey, avalue)> <!ELEMENT akey (#PCDATA)> <!ELEMENT avalue (#PCDATA)>
| Element | Meaning |
|---|---|
| pctype | The type of the node to be inserted. |
| pkey | The key that identifies the node within its type. |
| pguid | Needs not to be filled if the node type has been defined by the plug-in itself. It is used to refer to node types of other plug-ins, if these are known. |
| pinfo | Additional information about the node that the plug-in wants to receive back whenever Natural Studio later refers to the node. Natural Studio never considers the content of this element, put just passes it back and forth. |
| pname | The text to be displayed with the node. |
| ntype | If the node has been defined by a plug-in, but corresponds to a node of a predefined Natural Studio type, this element contains the type of the corresponding predefined node. |
| nkey | If the node has been defined by a plug-in, but corresponds to a node of a predefined Natural node type, this element contains the key of the corresponding predefined node. |
| attributevalues | The attribute values to be displayed with the node. These
are specified as an XML document according to the DTD used with the method
INaturalStudioPlugInTree::GetAttributeValues.
|
To avoid flickering, the result view is not redrawn after each call to
InsertRows. After a series of calls to
InsertRows the method Update
should be called to redraw the result view.
Makes the specified row visible and scrolls the result view if necessary.
| Name | Natural Data Format | Variant Type | Remark |
|---|---|---|---|
| Row | I4 | VT_I4 |
Contains the number of the row to be scrolled into view. To
position to the last inserted row, use the row number that was returned from
the method InsertRows.
Removes all rows from the result view.
Closes the result view.
