Arbortext Command Language > Functions by Alphabetical Listing > dlgitem_set_focus
  
dlgitem_set_focus
dlgitem_set_focus (win, dlgitem)
Changes the current keyboard focus of the window specified by win to the dialog item specified by dlgitem. If win is invalid, or if dlgitem does not exist within win, 0 is returned. If successful, the function returns 1.
The win parameter is a window identifier. dlgitem is the value of the control's id attribute.
Note that this function also changes the default focus item for the window so that the next time the window is opened, the specified dlgitem will receive focus. If the window is already open, the current focus item will be unfocused and new item will be given focus.
Example
$ret = dlgitem_set_focus($win,"matchMarkup")
Related Topics
dlgitem_get_focus function