The WIDGET_INFO function is used to obtain information about the widget subsystem and individual widgets. The specific area for which information is desired is selected by setting the appropriate keyword.
Result = WIDGET_INFO( [Widget_ID] )
Keywords that apply to all widgets: [, /ACTIVE] [, /CHILD] [, /EVENT_FUNC] [, /EVENT_PRO] [, FIND_BY_UNAME=string] [, /FONTNAME] [, /GEOMETRY] [, /KBRD_FOCUS_EVENTS] [, /MANAGED] [, /MAP] [, /NAME] [, /PARENT] [, /REALIZED] [, /SENSITIVE] [, /SIBLING] [, /SYSTEM_COLORS] [, /TRACKING_EVENTS] [, /TYPE] [, UNITS={0 | 1 | 2}] [, /UNAME] [, /UPDATE] [, /VALID_ID] [, /VERSION] [, /VISIBLE]
Keywords that apply to widgets created with WIDGET_BASE: [, /CONTEXT_EVENTS] [, /MODAL] [, /TLB_ICONIFY_EVENTS] [, /TLB_KILL_REQUEST_EVENTS] [, /TLB_MOVE_EVENTS] [, /TLB_SIZE_EVENTS]
Keywords that apply to widgets created with WIDGET_BUTTON: [, /BUTTON_SET] [, /DYNAMIC_RESIZE] [, /PUSHBUTTON_EVENTS] [, /TOOLTIP]
Keywords that apply to widgets created with WIDGET_COMBOBOX: [, /COMBOBOX_GETTEXT] [, /COMBOBOX_NUMBER] [, /DYNAMIC_RESIZE]
Keywords that apply to widgets created with WIDGET_DRAW: [, /DRAW_BUTTON_EVENTS] [, /DRAW_EXPOSE_EVENTS] [, DRAW_KEYBOARD_EVENTS={0 | 1 | 2}] [, /DRAW_MOTION_EVENTS] [, /DRAW_VIEWPORT_EVENTS] [, /TOOLTIP]
Keywords that apply to widgets created with WIDGET_DROPLIST: [, /DROPLIST_NUMBER] [, /DROPLIST_SELECT] [, /DYNAMIC_RESIZE]
Keywords that apply to widgets created with WIDGET_LABEL: [, /DYNAMIC_RESIZE]
Keywords that apply to widgets created with WIDGET_LIST: [, /CONTEXT_EVENTS] [, /LIST_MULTIPLE] [, /LIST_NUMBER] [, /LIST_NUM_VISIBLE] [, /LIST_SELECT] [, /LIST_TOP]
Keywords that apply to widgets created with WIDGET_PROPERTYSHEET: [, COMPONENT=objref] [, /PROPERTY_VALID] [, /PROPERTY_VALUE]
Keywords that apply to widgets created with WIDGET_SLIDER: [, /SLIDER_MIN_MAX]
Keywords that apply to widgets created with WIDGET_TAB: [, /TAB_CURRENT] [, /TAB_MULTILINE] [, /TAB_NUMBER]
Keywords that apply to widgets created with WIDGET_TABLE: [, /COLUMN_WIDTHS] [, /ROW_HEIGHTS{not supported in Windows}] [, /TABLE_ALL_EVENTS] [, /TABLE_DISJOINT_SELECTION] [, /TABLE_EDITABLE] [, /TABLE_EDIT_CELL] [, /TABLE_SELECT] [, /TABLE_VIEW] [, /USE_TABLE_SELECT]
Keywords that apply to widgets created with WIDGET_TEXT: [, /CONTEXT_EVENTS] [, /TEXT_ALL_EVENTS] [, /TEXT_EDITABLE] [, /TEXT_NUMBER] [, TEXT_OFFSET_TO_XY=integer] [, /TEXT_SELECT] [, /TEXT_TOP_LINE] [, TEXT_XY_TO_OFFSET=[column, line]]
Keywords that apply to widgets created with WIDGET_TREE: [, /TREE_EXPANDED] [, /TREE_ROOT] [, /TREE_SELECT]
Returns the specified information for the given widget ID. If the SYSTEM_COLORS keyword is specified, a structure is returned. See The WIDGET_SYSTEM_COLORS Structure for details.
Usually this argument should be the widget ID of the widget for which information is desired. If the ACTIVE or VERSION keywords are specified, this argument is not required.
Widget_ID can also be an array of widget identifiers, in which case the result is an array with the same structure in which information on all the specified widgets is returned.
Not all keywords to WIDGET_INFO apply to all combinations of widgets. In the following list, descriptions of keywords that affect only certain types of widgets include a list of the widgets for which the keyword is useful.
This keyword applies to all widgets.
Set this keyword to return 1 if there is at least one realized, managed, top-level widget on the screen. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_BUTTON function.
Set this keyword to return the "set" state of a widget button. If the button is currently set, 1 (one) is returned. If the button is currently not set, 0 (zero) is returned. This keyword is intended for use with exclusive, non-exclusive and checked menu buttons.
This keyword applies to all widgets.
Set this keyword to return the widget ID of the first child of the widget specified by Widget_ID. If the widget has no children, 0 is returned.
This keyword applies to widgets created with the WIDGET_TABLE function.
Set this keyword to return an array of long integers giving the width of each column in the table. If USE_TABLE_SELECT is set equal to one, only the column widths for columns that contain currently-selected cells are returned. If USE_TABLE_SELECT is set equal to an array, only the column widths for columns that contain specified cells are returned.
This keyword applies to widgets created with the WIDGET_COMBOBOX function.
Set this keyword to return the current text from the text box of the specified combobox widget. Note that when using an editable combobox, the text displayed in the text box may not be an item from the list of values in the combobox list. To obtain the index of the selected item, inspect the INDEX field of the event structure returned by the combobox widget.
This keyword applies to widgets created with the WIDGET_COMBOBOX function.
Set this keyword to return the number of elements currently contained in the list of the specified combobox widget.
This keyword applies to widgets created with the WIDGET_PROPERTYSHEET function. Set this keyword to an object reference to indicate which object to query. This is most useful when the property sheet references multiple objects. If this keyword is not specified, the first (possibly only) object is queried.
This keyword applies to widgets created with the WIDGET_BASE, WIDGET_LIST, or WIDGET_TEXT functions.
Set this keyword to return 1 (one) if the widget specified by Widget_ID is configured to generate context events (that is, the widget was created with the CONTEXT_EVENTS keyword). Otherwise, 0 (zero) is returned.
This keyword applies to widgets created with the WIDGET_DRAW function.
Set this keyword to return 1 if Widget_ID is a draw widget with the BUTTON_EVENTS attribute set. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_DRAW function.
Set this keyword to return 1 if Widget_ID is a draw widget with the EXPOSE_EVENTS attribute set. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_DRAW function.
Set this keyword to return an integer specifying the type of keyboard events currently generated by the draw widget specified by Widget_ID. Possible values are:
| Note |
This keyword applies to widgets created with the WIDGET_DRAW function.
Set this keyword to return 1 if Widget_ID is a draw widget with the MOTION_EVENTS attribute set. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_DRAW function.
Set this keyword to return 1 if Widget_ID is a draw widget with the VIEWPORT_EVENTS attribute set. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_DROPLIST function.
Set this keyword to return the number of elements currently contained in the specified droplist widget.
This keyword applies to widgets created with the WIDGET_DROPLIST function.
Set this keyword to return the zero-based number of the currently-selected element (i.e., the currently-displayed element) in the specified droplist widget.
This keyword applies to widgets created with the WIDGET_BUTTON, WIDGET_COMBOBOX, WIDGET_DROPLIST, and WIDGET_LABEL functions.
Set this keyword to return a True value (1) if the widget specified by Widget_ID is a button, droplist, or label widget that has had its DYNAMIC_RESIZE attribute set. Otherwise, False (0) is returned.
This keyword applies to all widgets.
Set this keyword to return a string containing the name of the event handler function associated with Widget_ID. A null string is returned if no event handler function exists.
This keyword applies to all widgets.
Set this keyword to return a string containing the name of the event handler procedure associated with Widget_ID. A null string is returned if no event handler procedure exists.
This keyword applies to all widgets.
Set this keyword to a UNAME value that will be searched for in the widget hierarchy, and if a widget with the given UNAME is in the hierarchy, its ID is returned. The search starts in the hierarchy with the given widget ID and travels down, and this keyword returns the widget ID of the first widget that has the specified UNAME value.
If a widget is not found, 0 is returned.
This keyword applies to all widgets.
Set this keyword to return a string containing the name of the font being used by the specified widget. The returned name can then be used when creating other widgets or with the SET_FONT keyword to the DEVICE procedure. If fonts are not supported by the specified widget, an empty string is returned.
Note that you can use this keyword to retrieve the name of the default font used by one type of widget and use the same font in other contexts. For example, the following code retrieves the default font used for buttons and writes into the drawable area of a draw widget using the same font:
wBase = WIDGET_BASE(/ROW) wButton = WIDGET_BUTTON(wBase, VALUE="Button") wDraw = WIDGET_DRAW(wBase, XSIZE=200, YSIZE=100) WIDGET_CONTROL, wBase, /REALIZE strFont = WIDGET_INFO(wButton, /FONTNAME) DEVICE, SET_FONT=strFont WIDGET_CONTROL, wDraw, GET_VALUE=iWindow WSET, iWindow XYOUTS, 100, 50, 'Same Font as Button', FONT=0, /DEVICE, $ ALIGNMENT=.5
This method allows you to synchronize the fonts in several widgets without knowing in advance which font is in use.
The format of the returned font name is platform dependent. See About Device Fonts for additional details.
This keyword applies to all widgets.
| Note |
Set this keyword to return a WIDGET_GEOMETRY structure that describes the offset and size information for the widget specified by Widget_ID. This structure has the following definition:
{ WIDGET_GEOMETRY,
XOFFSET:0.0,
YOFFSET:0.0,
XSIZE:0.0,
YSIZE:0.0,
SCR_XSIZE:0.0,
SCR_YSIZE:0.0,
DRAW_XSIZE:0.0,
DRAW_YSIZE:0.0,
MARGIN:0.0,
XPAD:0.0,
YPAD:0.0,
SPACE:0.0 }
With the exception of MARGIN, all of the structure's fields correspond to the keywords of the same name to the various widget routines. MARGIN is the width of any frame added to the widget, in units specified by the UNITS keyword (pixels are the default). Therefore, the actual width of any widget is:
SCR_XSIZE + (2* MARGIN)
The actual height of any widget is:
SCR_YSIZE + (2 * MARGIN)
| Note |
This keyword applies to all widgets.
Set this keyword to return the keyboard focus events status of the widget specified by Widget ID. WIDGET_INFO returns 1 (one) if keyboard focus events are currently enabled for the widget, or 0 (zero) if they are not. Only base, table, and text widgets can generate keyboard focus events.
This keyword applies to widgets created with the WIDGET_LIST function.
Set this keyword equal to a named variable that will contain a non-zero value if the list widget supports multiple item selections. See the MULTIPLE keyword to WIDGET_LIST for more on multiple item selections.
This keyword applies to widgets created with the WIDGET_LIST function.
Set this keyword to return the number of elements currently contained in the specified list widget.
This keyword applies to widgets created with the WIDGET_LIST function.
Set this keyword to return the number of elements that can be visible in the scrolling viewport of the specified list widget. Note that this value can be larger than the total number of elements actually in the list.
This keyword applies to widgets created with the WIDGET_LIST function.
Set this keyword to return the index or indices of the currently-selected (highlighted) element or elements in the specified list widget. Note that this offset is zero-based. If no element is currently selected, -1 is returned.
This keyword applies to widgets created with the WIDGET_LIST function.
Set this keyword to return the zero-based offset of the topmost element currently visible in the specified list widget.
This keyword applies to all widgets.
Set this keyword to return 1 if the specified widget is managed, or 0 otherwise. If no widget ID is specified in the call to WIDGET_INFO, the return value will be an array containing the widget IDs of all currently-managed widgets.
This keyword applies to all widgets.
Set this keyword to return True (1) if the widget specified by Widget_ID is mapped (visible), or False (0) otherwise. Note that when a base widget is unmapped, all of its children are unmapped. If WIDGET_INFO reports that a particular widget is unmapped, it may be because a parent in the widget hierarchy has been unmapped.
This keyword applies to widgets created with the WIDGET_BASE function and the MODAL keyword.
If this keyword is set, WIDGET_INFO will return True (1) if the base widget specified by Widget_ID is a modal base widget, or False (0) otherwise.
This keyword applies to all widgets.
Set this keyword to return the widget type name of the widget specified by Widget_ID. The returned value will be one of the following strings: "BASE", "BUTTON", "COMBOBOX", "DRAW", "DROPLIST", "LABEL", "LIST", "PROPERTYSHEET", "SLIDER", "TAB", "TABLE", "TEXT", or "TREE". Set the TYPE keyword to return the widget's type code.
This keyword applies to all widgets.
Set this keyword to return the widget ID of the parent of the widget specified by Widget_ID. If the widget is a top-level base (i.e., it has no parent), 0 is returned.
This keyword applies to widgets created with the WIDGET_PROPERTYSHEET function. Set this keyword to a string to determine if the string identifies a property. Valid identifiers return 1 and invalid strings return 0. Comparisons are case insensitive.
Operations are performed on properties through unique identifiers. This operation is not required when processing a change event because the identifier returned in the event structure can be assumed to be correct.
This keyword applies to widgets created with the WIDGET_PROPERTYSHEET function. Retrieves the value of an identified property from a property sheet and returns it as a temporary IDL variable. Set this keyword to a string that is a valid property identifier in order to return the value of the specified property. This value can then be used to set the actual value of the component's property-the property sheet does not automatically do this. When there are multiple components, use the COMPONENT keyword to indicate which component should be queried. The match is case insensitive. An invalid identifier throws an error.
This keyword is very often used in response to property sheet change events. This is because the property sheet does not change the underlying component; it only informs the widget program which of its own values have changed. The IDL programmer can use PROPERTY_VALUE to retrieve the user's desired value (as cached in the property sheet) and then apply it to the component. The following snippet of code handles property sheet change events:
PRO prop_event, e ; get the value of e.component's property identified by ; e.identifier value = widget_info( e.id, $ component = e.component, $ property_value = e.identifier ) ; set the component's property's value e.component -> SetPropertyByIdentifier, $ e.identifier, value END
This keyword applies to widgets created with the WIDGET_BUTTON function.
Set this keyword to return the pushbutton events status for the widget specified by Widget_ID. WIDGET_INFO returns 1 if pushbutton events are currently enabled for the widget, or 0 otherwise.
This keyword applies to all widgets.
Set this keyword to return 1 if the widget specified by Widget_ID has been realized. If the widget has not been realized, 0 is returned.
This keyword applies to widgets created with the WIDGET_TABLE function.
| Note |
Set this keyword to return an array of long integers giving the height of each row in the table. If USE_TABLE_SELECT is set equal to one, only the row heights for rows that contain currently-selected cells are returned. If USE_TABLE_SELECT is set equal to an array, only the row heights for rows that contain specified cells are returned.
This keyword applies to all widgets.
Set this keyword to return True (1) if the widget specified by Widget_ID is sensitive (enabled), or False (0) otherwise. Note that when a base is made insensitive, all its children are made insensitive. If WIDGET_INFO reports that a particular widget is insensitive, it may be because a parent in the widget hierarchy has been made insensitive.
This keyword applies to all widgets.
Set this keyword to return the widget ID of the first sibling of the widget specified by Widget_ID. If the widget is the last sibling in the chain, 0 is returned.
This keyword applies to widgets created with the WIDGET_SLIDER function.
Set this keyword to return the current minimum and maximum values of the specified slider as a two-element integer array. Element 0 is the minimum value and element 1 is the maximum value.
This keyword applies to all widgets.
Set this keyword and supply the widget ID of any widget to cause WIDGET_INFO to return an IDL structure that contains RGB values used for 25 IDL display elements.
For more detailed information on the WIDGET_SYSTEM_COLORS structure fields and their meaning see the The WIDGET_SYSTEM_COLORS Structure.
This keyword applies to widgets created with the WIDGET_TAB function.
Set this keyword to return the zero-based index of the current tab in the tab widget.
This keyword applies to widgets created with the WIDGET_TAB function.
Set this keyword to return the current setting of the multi-line mode for the tab widget.
This keyword applies to widgets created with the WIDGET_TAB function.
Set this keyword to return the number of tabs contained in the tab widget.
This keyword applies to widgets created with the WIDGET_TABLE function.
Set this keyword to return 1 (one) if Widget_ID is a table widget with the ALL_EVENTS attribute set. Otherwise, 0 (zero) is returned.
This keyword applies to widgets created with the WIDGET_TABLE function.
Set this keyword to return 1 (one) if the widget specified by Widget_ID has disjoint selection enabled. Otherwise, 0 (zero) is returned.
This keyword applies to widgets created with the WIDGET_TABLE function.
Set this keyword to return 1 (one) if Widget_ID is a table widget that allows user editing of its contents. Otherwise, 0 (zero) is returned.
This keyword applies to widgets created with the WIDGET_TABLE function.
Set this keyword to return a two-element integer array containing the row and column coordinates of the currently editable cell. If none of the cells in the table widget is currently editable, the array [-1, -1] is returned.
This keyword applies to widgets created with the WIDGET_TABLE function.
Set this keyword to return the currently-selected (highlighted) cells in the specified table widget.
This keyword applies to widgets created with the WIDGET_TABLE function.
Set this keyword to return a two-element array of the form [left, top] containing the zero-based offsets of the top-left cell currently visible in the specified table widget.
This keyword applies to widgets created with the WIDGET_TEXT function.
Set this keyword to return 1 if Widget_ID is a text widget with the ALL_EVENTS attribute set. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_TEXT function.
Set this keyword to return 1 if Widget_ID is a text widget that allows user editing of its contents. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_TEXT function.
Set this keyword to return the number of characters currently contained in the specified text widget, including end-of-line characters.
| Note |
This keyword applies to widgets created with the WIDGET_TEXT function.
Use this keyword to translate a text widget character offset into column and line form. The value of this keyword should be set to the character offset (an integer) to be translated. WIDGET_INFO returns a two-element integer array giving the column (element 0) and line (element 1) corresponding to the offset. If the offset specified is out of range, the array [-1,-1] is returned.
This keyword applies to widgets created with the WIDGET_TEXT function.
Set this keyword to return the starting character offset and length (in characters) of the selected (highlighted) text in the specified text widget. WIDGET_INFO returns a two-element integer array containing the starting position of the highlighted text as an offset from character zero of the text in the widget (element 0), and length of the current selection (element 1).
This keyword applies to widgets created with the WIDGET_TEXT function.
Set this keyword to return the zero-based line number of the line currently at the top of a text widget's display viewport. Note that this value is different from the zero-based character offset of the characters in the line. The character offset can be calculated from the line offset via the TEXT_XY_TO_OFFSET keyword.
This keyword applies to widgets created with the WIDGET_TEXT function.
Use this keyword to translate a text widget position given in line and column form into a character offset. The value of this keyword should be set to a two-element integer array specifying the column (element 0) and line (element 1) position. WIDGET_INFO returns the character offset (as a longword integer) corresponding to the position. If the position specified is out of range, -1 is returned.
This keyword applies to widgets created with the WIDGET_BASE function.
Set this keyword to return 1 if the top-level base widget specified by Widget_ID is set to return iconify events. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_BASE function.
Set this keyword to return 1 if the top-level base widget specified by Widget_ID is set to return kill request events. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_BASE function.
Set this keyword to return 1 if the top-level base widget specified by Widget_ID is set to return move events. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_BASE function.
Set this keyword to return 1 if the top-level base widget specified by Widget_ID is set to return resize events. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_BUTTON and WIDGET_DRAW functions.
Set this keyword to have the WIDGET_INFO function return the text of the tooltip of the widget. If the widget does not have a tooltip, a null string will be returned.
This keyword applies to all widgets.
Set this keyword to return the tracking events status for the widget specified by Widget_ID. WIDGET_INFO returns 1 if tracking events are currently enabled for the widget. Otherwise, 0 is returned.
This keyword applies to widgets created with the WIDGET_TREE function.
Set this keyword to return 1 (one) if the specified tree widget node is a folder that is expanded, or 0 (zero) if the specified node is a folder that is collapsed.
| Note |
This keyword applies to widgets created with the WIDGET_TREE function.
Set this keyword to return the widget ID of the root node of the tree widget hierarchy of which Widget ID is a part. The root node is the tree widget whose parent is a base widget.
This keyword applies to widgets created with the WIDGET_TREE function.
Set this keyword to return information about the nodes selected in the specified tree widget. This keyword has two modes of operation, depending on the widget ID passed to WIDGET_INFO:
This keyword applies to all widgets.
Set this keyword to return the type code of the specified Widget_ID. Possible values are given the following table. Note that you can set the NAME keyword to return string names instead.
|
Value
|
Type
|
|---|---|
| 0 |
Base
|
| 1 |
Button
|
| 2 |
Slider
|
| 3 |
Text
|
| 4 |
Draw
|
| 5 |
Label
|
| 6 |
List
|
| 8 |
Droplist
|
| 9 |
Table
|
| 10 |
Tab
|
| 11 |
Tree
|
| 12 |
Combobox
|
This keyword applies to all widgets.
Set this keyword to have the WIDGET_INFO function return the user name of the widget.
This keyword applies to all widgets.
Use this keyword to specify the unit of measurement used when returning dimensions for most widget types. Set UNITS equal to 0 (zero) to specify that all measurements are in pixels (this is the default), to 1 (one) to specify that all measurements are in inches, or to 2 (two) to specify that all measurements are in centimeters.
| Note |
This keyword applies to all widgets.
Set this keyword to return 1 if the widget hierarchy that contains Widget_ID is set to display updates. Otherwise, 0 is returned. See UPDATE.
This keyword applies to widgets created with the WIDGET_TABLE function.
Set this keyword to modify the behavior of the COLUMN_WIDTHS and ROW_HEIGHTS keywords. If USE_TABLE_SELECT is set, the COLUMN_WIDTHS and ROW_HEIGHTS keywords only apply to the currently-selected cells. Normally, these keywords apply to the entire contents of a table widget.
The USE_TABLE_SELECT keyword can also be specified as a four-element array, of the form [left, top, right, bottom], giving the group of cells to act on. In this usage, the value -1 is used to refer to the row or column titles.
This keyword applies to all widgets.
Set this keyword to return 1 if Widget_ID represents a currently-valid widget. Otherwise, 0 is returned.
This keyword applies to all widgets.
Set this keyword to return a structure that gives information about the widget implementation. This structure has the following definition:
{ WIDGET_VERSION, STYLE:'', TOOLKIT:'', RELEASE:'' }
STYLE is the style of widget toolkit used. TOOLKIT is the implementation of the toolkit. RELEASE is the version level of the toolkit. This field can be used to distinguish between different releases of a given toolkit, such as Motif 1.0 and Motif 1.1.
This keyword applies to all widgets.
Set this keyword to return True (1) if the widget specified by Widget_ID is visible, or False (0) otherwise. A widget is visible if:
| Note |
When the SYSTEM_COLORS keyword is specified in a call to WIDGET_INFO, IDL returns a WIDGET_SYSTEM_COLORS structure. This allows application developers to determine what colors are used in IDL application widgets, so they can design widgets for their application with the same look and feel as the supplied IDL widgets.
The WIDGET_SYSTEM_COLORS structure consists of 25 fields, each containing a three-element vector corresponding to the Red, Green, and Blue color values used for various widget elements. The vector elements are integers ranging between 0 and 255 if a color value is available (vector elements contain -1 if the color value is unavailable). The field names and meaning on the Windows and UNIX operating systems are shown in the following table.
Introduced: Pre 4.0
BUTTON_SET, COMBOBOX_GETTEXT, COMBOBOX_NUMBER, FONTNAME, MAP, SENSITIVE, TAB_CURRENT, TAB_MULTILINE, TAB_NUMBER, TABLE_DISJOINT_SELECTION, TLB_ICONIFY_EVENTS, TLB_MOVE_EVENTS, TLB_SIZE_EVENTS, TOOLTIP, TREE_EXPANDED, TREE_ROOT, TREE_SELECT, and VISIBLE keywords added: 5.6
PUSHBUTTON_EVENTS keyword added: 6.0