Arbortext Command Language > Functions by Alphabetical Listing > dlgitem_get_check_at
  
dlgitem_get_check_at
dlgitem_get_check_at (window, listtag, row)
Returns the check state of the specific checkable outline list entry row in the checkable outline list listtag in window. If listtag does not refer to a checkable outline list list tag, $ERROR is set and 0 is returned. Otherwise, the check state is returned.
Possible return values:
0 — list entry is not checked.
1 — list entry is checked.
–1 — list entry contains intermediate check. This results when a list entry contains a sublisttag with some list entries checked, but not all.
The window parameter is a window identifier. The listtag parameter is a checkable outline list list tag (case sensitive). The row parameter is an offset into listtag (starting from one).
Example
$ret = dlgitem_get_check_at($win, "Hierarchy", 3)
Returns the check state of the third item in the checkable outline list item Hierarchy.