This document covers the following topics:
Collection of the currently open list view document windows.
The following properties are available:
Used to navigate to the parent interface of this interface.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| HANDLE OF OBJECT | DISPATCH (INatAutoObjects) | Get only |
Used to navigate to the root interface.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| HANDLE OF OBJECT | VT_DISPATCH (INatAutoStudio) | Get only |
The number of currently open list view document windows.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| I4 | VT_I4 | Get only |
The following methods are available:
Returns a specific list view document window from the collection.
| Name | Natural Data Format | Variant Type | Remark |
|---|---|---|---|
| Return value | HANDLE OF OBJECT | VT_DISPATCH (INatAutoObjectList) | |
| Index | I4 | VT_I4 |
- Return value
The list view document window identified by the value specified in Index.
- Index
Identifies a specific list view document window in the collection. This is a value between 1 and Count.
Opens a new list view document window.
| Name | Natural Data Format | Variant Type | Remark |
|---|---|---|---|
| Return value | HANDLE OF OBJECT | VT_DISPATCH (INatAutoObjectList) | |
| Type | I4 | VT_I4 | |
| Key | A | VT_BSTR | |
| Caption | A | VT_BSTR | |
| Template | I4 | VT_I4 | Optional |
| PlugInID | A | VT_BSTR | Optional |
| Info | A | VT_BSTR | Optional |
| DisplayName | A | VT_BSTR | Optional |
| Children | A | VT_BSTR | Optional |
| NaturalType | I4 | VT_I4 | Optional |
| NaturalKey | A | VT_BSTR | Optional |
- Return value
The newly opened list view document.
- Type
The node type of the root object. This must be a plug-in defined type that may correspond to a predefined Natural Studio type.
- Key
The key that identifies the object within its type.
- Caption
Determines the caption of the document window.
In order to generate a caption that matches the caption format used in Natural Studio document windows, the string passed in this parameter may contain the format specifier
%std. This format specifier will be dynamically replaced by an identifier of the root object in the following way: If the root node corresponds to a predefined Natural Studio object, the format specifier%stdis replaced by "name [library] -". Otherwise the identifier is built in the form "node-type-caption display-name -", where node-type-caption is the caption that was passed when the node type was created and display-name is the string passed in DisplayName.- Template
The value specified here is passed back to the plug-in when Natural Studio later calls the plug-in through the interface
INaturalStudioPlugInTreein order to retrieve data to fill the view. This enables the plug-in to deliver different data for the same root object.- PlugInID
The ID of the plug-in that defined the type.
- Info
Additional information that a plug-in may want to assign to the root object. Natural Studio does not interpret this information. It just passes it back to the plug-in when it later calls the plug-in through the interface
INaturalStudioPlugInTreein order to retrieve data to fill the view.- DisplayName
The text to be displayed at the root node.
- Children
If the plug-in already knows the child nodes of the root node, it can pass them in this parameter. The parameter must then contain an XML document describing the child nodes. The XML document is structured according to the DTD defined in
INaturalStudioPlugInTree::GetChildren. If this parameter is specified, Natural Studio implicitly assumes that the root node has child nodes and performs no call through the interfaceINaturalStudioPlugInTreeto determine if the root node has child nodes.- NaturalType
If the root node corresponds to a predefined Natural Studio object, this property contains the type of the corresponding predefined object.
- NaturalKey
If the root node corresponds to a predefined Natural Studio object, this property contains the key of the corresponding predefined object.