ProjectTree (IProjectTree65)

The IProjectTree65 interface allows you to manipulate the Project Tree items. This includes managing groups, items and layers. A Tree item is a group if it can have children items. It is important to note that items that are not groups can only be added through the ICreator65 interface, since it is used to create all the entities of TerraExplorer. These entities (i.e., a polyline on the terrain) are then represented in the Project Tree (as items inside groups). To rename an item in the Project Tree that is not a group, you should use the interface of that item. If you need to access a Project Tree element (for example, to change its position on the terrain) you use its ID that uniquely identifies it in the TerraExplorer Pro world (the ITerraExplorerObject65. ID property) to get an interface to that object using the GetObject  method.

Note:    In API version 6.5, elements no longer have an additional separate Project Tree ID; they only have a single object ID.

 

 

Properties

 

HiddenGroupID

Reserved. Currently not used.

HiddenGroupName

Reserved. Currently not used.

NotInTreeID

Returns the ID that should be passed as an element’s ParentGroupID, if you do not want the element added to the Project Tree.

RootID

Returns the ID of the Tree root element.

 

Methods

 

CreateGroup

Creates a group in the Project Tree.

CreateLockedGroup

Creates a group in a “locked” (collapsed) mode. When locked, TerraExplorer Viewer users cannot expand the group to view its contents.

DeleteItem

Deletes an item from the Tree (and from the terrain, if that item was a terrain object).

EditItem

Opens the edit properties sheet to edit the item.

EditItems

Opens the edit properties sheet to edit a group of items.

EnableRedraw

Enables changes to be redrawn or prevents them from being redrawn in the Project Tree.

EndEdit

Terminates the edit item mode.

ExpandGroup

Expands the group so that it displays all of its children, or collapses it.

FindItem

Finds an item using a path to that item.

GetActivationCode

Returns the activation code assigned for the specified group.

GetClientData

Returns the text string describing the group’s attribute data. This information is available for general use in your application.

GetGroupEndTime

Returns the group’s end date and time.

GetGroupLocation

Returns the location of the specified group.

GetGroupStartTime

Returns the group’s start date and time.

GetItemName

Returns the name of a certain item using its ID.

GetLayer

Returns an interface to the IFeatureLayer65 object based on the ID.

GetNextItem

Retrieves the Tree item that has the specified relationship, indicated by the Code parameter, to another item whose ID is specified.

GetObject

Returns an interface to the object based on a requested ITerraExplorerObject derived interface.

GetVisibility

Returns the visibility status of a Project Tree item on the terrain.

IsGroup

Determines whether or not a ProjectTree item is a group.

IsLayer

Obsolete

IsLocked

Determines whether a group is locked, or not.

LoadFlyLayer

Loads a Fly file into the current project. All the objects from the Fly file, including locations, routes and hyperlinks, are added.

LockGroup

Sets a group to a “lock” (collapsed) status mode. When a group is locked, users of TerraExplorer Viewer cannot expand the group and view its contents.

RenameGroup

Renames a group in the Project Tree.

SaveAsFly

Saves the specified group to a Fly file.

SaveAsKml

Saves the specified group to a KML file.

SelectItem

Selects an item in the Project Tree.

SetActivationCode

Determines the default activation action executed when clicking on the locked group symbol.

SetClientData

Stores a text string in the group global namespace.

SetGroupEndTime

Determines the date and time when the group should stop being visible

SetGroupLocation

Determines the location parameters for a specified group.

SetGroupStartTime

Determines the date and time when the group should start being visible

SetParent

Moves items to different groups.

SetVisibility

Sets a ProjectTree item to be visible, or not visible, on the terrain

ShowSubTree

Reserved

SortGroup

Sorts the items in the group according to specified sort type.