Arbortext Command Language > Functions by Alphabetical Listing > dlgitem_get_selected_appdata
  
dlgitem_get_selected_appdata
dlgitem_get_selected_appdata(window, dlgitem)
Returns the user-defined data associated with item dlgitem in window. If dlgitem contains no selection or the selected item contains no data, the function returns an empty string. If the function fails, it returns a NULL.
With XUI tree controls, this function returns the application-specific data for the selected node when in single selection mode. When the tree control is in multiple selection mode, the function returns the application-specific data for the first node in the selection.
window — A window identifier.
dlgitem — The value of the control's id attribute.
Example
$top = dlgitem_get_selected_appdata($win, "Hierarchy")
Returns the selected item in the Hierarchy list.