Home > Working with SGWorld > ProjectTree (IProjectTree6)

ProjectTree (IProjectTree6)

The IProjectTree6 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 ICreator6 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 use the interface of that item. Each item in the tree has a unique tree-item ID. If you need to access the object that the item represents (for example, to change its position on the terrain) you use the GetObject method to get an interface to that object (If Project.GetTerraObjectID() fails, it might be that the tree-item ID that you are trying to access is actually a group (which has no interface).

 

 

Properties

 

HiddenGroupID

Reserved. Currently not used.

HiddenGroupName

Reserved. Currently not used.

 

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 Item ID.

GetLayer

Returns an interface to the ILayer6 object based on the ItemID.

GetNextItem

Returns the tree item that has the specified relationship, indicated by the Code parameter, to ItemID.

GetObject

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

GetTerraObjectID

Uses ItemID to retrieve the actual object ID associated with this tree item ID entry.

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

Determines whether a Project Tree item is a feature layer.

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.

LoadKmlLayer

Loads a KML file into the current project.

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 groups, and returns the new ItemID assigned to the item.

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.