Arbortext Command Language > Functions by Alphabetical Listing > dlgitem_get_sublisttag
  
dlgitem_get_sublisttag
dlgitem_get_sublisttag(window, dlgitem, listtag, row[, nobranchconv])
Returns the list tag of the sublist of the given list tag (in outline lists), or optionally inserts and returns a new, empty sublist as a child of the given row of the existing list tag within item dlgitem in window. If the function fails, it returns an empty string.
window — The window identifier.
dlgitem — The value of the control's id attribute.
listtag — The list tag for which the function returns the sublist.
row — Specifies which row of the sublist to return.
nobranchconv — Optional. If 1, and the tree node specified is a leaf, the leaf will not be converted to a branch, allowing users to get the list tag of a leaf without changing anything. If nobranchconv is 0, the leaf is converted to a branch. The default is 0
Example
$top = dlgitem_get_listtag($win, "Hierarchy")
$ret = dlgitem_get_sublisttag($win, "Hierarchy", $Top,0)
Returns the child of the first entry in the Hierarchy list.