Arbortext Command Language > Functions by Alphabetical Listing > dlgitem_get_value
  
dlgitem_get_value
dlgitem_get_value (window, dlgitem)
Returns the VALUE attribute of dlgitem within window as a string. If window is invalid, or if dlgitem does not exist within window, then $ERROR is set and NULL is returned.
The window parameter is a window identifier. dlgitem is the value of the control's id attribute.
Examples
$ret = dlgitem_get_value($win, "TextField")
Notebooks can be queried. By using this function on a gpNotebook item, one can query which tab is active.
LINK_NOTEBOOK = "gpNotebookTagName"
# tab_value is an integer, which represents the position
# of the tabs by counting from left to right within
# the notebook.
function query_activate_tab(win) {
return dlgitem_get_value(win, LINK_NOTEBOOK)
}