TPUHELP.HLB  —  GET_INFO(WIDGET_VARIABLE)
  GET_INFO(WIDGET_VARIABLE)

  For an overview of the GET_INFO built-in, see the HELP topic GET_INFO.

  The following strings can be used for parameter2 when parameter1 is a
  variable of type widget:

  Parameter 2      | Return Value  (Parameter 1 is a variable of type widget)
  -----------------+----------------------------------------------------------
  "callback_       | Program      - The program or learn sequence
   routine"        |   or           that is called when the specified
                   | Learn          widget calls back.
                   |
  "class"          | String       - The name of the class to which
                   |                the specified widget belongs.
                   |
  "input_focus"    | (1 or 0)     - Returns 1 (TRUE) if the specified
                   |                widget currently has input focus;
                   |                returns 0 otherwise.
                   |
  "insertion_      | integer      - Returns location of insertion position
   position"       |                if the widget is a text widget. The
                   |                Insertion positions is between
                   |                characters. Values start at 0 which is
                   |                the position to the left of the first
                   |                character.
                   |
  "is_managed"     | (1 or 0)     - Returns 1 (TRUE) if the specified
                   |                widget is managed, 0 otherwise.
                   |                This built-in calls the DECwindows
                   |                Toolkit routine XtIsManaged
                   |
  "is_subclass"    | (1 or 0)     - The syntax of this GET_INFO call
                   |                is as follows:
                   |
                   |                GET_INFO (widget, "is_subclass", integer)
                   |
                   |                The integer parameter is the integer
                   |                returned by DEFINE_WIDGET_CLASS.
                   |
                   |                The call returns 1 (TRUE) if the specified
                   |                widget belongs to the class referred
                   |                to by the specified integer or belongs
                   |                to a subclass of that class.  A TRUE
                   |                value indicates only that the widget
                   |                is equal to or is a subclass of the
                   |                specified class; the value does not
                   |                indicate how far down the class
                   |                hierarchy the widget's class or subclass
                   |                is.
                   |
  "name"           | String       - The name of the specified widget instance.
                   |
  "parent"         | Widget       - The parent of the specified widget
                   | or 0           instance.  If the widget has no parent,
                   |                this GET_INFO call returns 0.
                   |
  "resources"      | Array        - A string-indexed array in which each
                   |                index is a valid resource name for the
                   |                specified widget.  The corresponding
                   |                array element is a string containing
                   |                the resource's data type and class,
                   |                separated by a line feed (ASCII (10)).
                   |
  "text"           | String       - The text in a simple text widget.
                   |
  "widget_info"    | Array        - Values for various resources of the
                   |   or           specified widget.
                   | Pairs of
                   | arguments      The syntax for this call is as follows:
                   |
                   |                GET_INFO (widget_variable, "widget_info",
                   |                         {array | resource_and_value
                   |                         [,array | resource_and_value...]})
                   |
                   |                The values are returned using elements
                   |                of the array or arrays, or the variable
                   |                or variables containing the resource
                   |                values, or a mixture of array elements
                   |                and variables. If there are no values
                   |                to return, TPU assigns an empty
                   |                array to the third parameter.
                   |
                   |                This GET_INFO call is functionally
                   |                equivalent to the DECwindows Toolkit
                   |                GET VALUES routine.
  +----------------+---------------------------------------------------------+
Close Help