GET_INFO(WIDGET)
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 the
keyword WIDGET:
Parameter 2 | Return Value (Parameter 1 is the keyword WIDGET)
+----------------+---------------------------------------------------------+
"callback_ | 1 or 0 - The value 1 if the call was encountered
parameters" | within a callback procedure and
| if callback information is available;
| 0 otherwise. The syntax of
| this built-in is as follows:
|
| GET_INFO (WIDGET, callback_parameters,
| array_variable)
|
| The third parameter is an array
| created by VAXTPU and assigned
| to "array_variable". After VAXTPU
| executes the call, the array elements
| contain the widget instance performing
| the callback, the closure value,
| and the callback reason. The array
| elements are indexed by the the
| following strings: "widget",
| "closure", "reason_code". If the
| application has used SET (WIDGET_CALL_DATA)
| to define the format of callback data
| for the widget and reason code that
| are returned by the current call to
| GET_INFO (WIDGET, "callback_parameters"),
| then the array parameter automatically
| receives a fourth element. The element
| is indexed with the string "call_data"
| and contains an integer-indexed array.
| The number of elements in this array is
| the same as the number of callback data
| structure fields specified in the
| corresponding SET (WIDGET_CALL_DATA) call.
| Element 1 contains the event field
| (for whcih the application usually
| specifies an output data type of
| UNSPECIFIED); subsequent elements
| hold the contents of subsequent
| callback data structure fields.
|
"children" | Integer - The number of widget children controlled
| by the specified widget or by VAXTPU's
| main window widget.
|
| The syntax of this GET_INFO call
| is as follows:
|
| GET_INFO (WIDGET, "children",
| {SCREEN | widget},
| array_variable)
|
| To specify VAXTPU's main window widget,
| use the keyword SCREEN; otherwise,
| specify the widget you want. If the
| widget has any children, VAXTPU creates
| an array and assigns it to the array
| variable. The array is integer-indexed;
| its elements contain the children.
| If the widget has no children, the
| array variable is assigned the type
| UNSPECIFIED.
|
"widget_id" | Widget - The widget instance corresponding to
| the widget name that you pass in as
| the fourth parameter. The syntax of
| this call is as follows:
|
| GET_INFO (WIDGET, "widget_id",
| {parent_widget | SCREEN},
| widget_name)
|
+----------------+----------------------------------------------------------+