ObjectDCL Banner

Tree_GetNextVisibleItem Method

Description

This method retrieves the unique key of the next visible tree item.

Parameters

MyControlReference
Reference to the control in the form of MyProject_MyForm_MyControl.
ProjectFile
String identifying the project as it was passed in LoadProject.
DialogName
String identifying the dialog by name.
ControlName
String identifying the control by name.
Key
String specifying the a unique key in the tree structure identifying the tree node.
Tree Node Handle specifying the tree node uniquely.

Return Values

Returns the following according to the situation:

  • String or Tree Node Handle if there is such a tree item.
  • Nil if the control is not found, is not visible or there is no child.

AutoLISP Syntax

The recommended convention is passing the control identifier directly:

CopyCode imageCopy Code
(Odcl_Tree_GetNextVisibleItem 
		MyControlReference [as Reference]
		Key [as String or Tree Node Handle])

An alternative convention is to identify the control by providing the project file, the dialog name and the control name:

CopyCode imageCopy Code
(Odcl_Tree_GetNextVisibleItem
		ProjectFile [as String]
		DialogName [as String]
		ControlName [as String]
		Key [as String or Tree Node Handle])

Applies For

TreeControl.

Example

CopyCode imageCopy Code
; Get the key of the next visible item
(Setq rValue (Odcl_Tree_GetNextVisibleItem MyProject_MyForm_MyControl "C_Documents and Settings"
))

See Also

Tree_EnsureVisible Tree_GetFirstVisibleItem, Tree_GetPrevVisibleItem, Tree_GetVisibleCount