Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

VAXTPU GET_INFO(SCREEN) — VMS 5.2

 GET_INFO(SCREEN)

 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 SCREEN:

 Parameter 2      | Return Value     (Parameter 1 is keyword SCREEN)
 -----------------+----------------------------------------------------------
 "active_area"    | Array    - An array containing information on the
                  |   or       location and dimensions of the application's
                  | Integer    active area, or 0 if there is no active
                  |            area.  The structure of the array is
                  |            as follows:
                  |            array {1} - Window containing active area
                  |            array {2} - Leftmost column of active area
                  |            array {3} - Top row of active area
                  |            array {4} - Width of active area
                  |            array {5} - Height of active area
 "ansi_crt"       | (1 or 0) - Indicates whether the terminal is an ANSI_CRT
 "auto__repeat"   | (1 or 0) - Indicates whether auto repeat feature is on
 "avo"            | (1 or 0) - Indicates whether the terminal has the
                  |            advanced video option (AVO)
 "cross_window_   | (1 or 0) - Indicates whether the CURSOR_VERTICAL built-in
 bounds"          |            crosses a window boundary when the cursor is
                  |            at the top or bottom of a window
 "current_column" | Integer  - Column number of the current column as of the
                  |            most recent screen update
 "current_row"    | Integer  - Screen line number of the current row as of
                  |            the most recent screen update
 "dec_crt"        | (1 or 0) - Indicates whether the terminal is a DEC_CRT
 "dec_crt2"       | (1 or 0) - Indicates whether the terminal is a DEC_CRT2
 "decwindows"     | (1 or 0) - Indicates whether the DECwindows environment
                  |            is available
 "edit_mode"      | (1 or 0) - Indicates whether the terminal is set to
                  |            edit mode
 "eightbit"       | (1 or 0) - Indicates whether the terminal uses eightbit
                  |            characters
 "event"          | Array    - If used in a routine providing information
                  |  or        about a global selection, returns a two-element
                  | Keyword    array.  Array {1} contains a keyword or string
                  |   or       identifying which global selection is
                  | String     the subject of the information request.
                  |  or        Array {2} contains a string naming the global
                  | Integer    selection property (such as text or line number)
                  |            that is the subject of the information request.
                  |            If called from within a global selection grab
                  |            or ungrab routine, returns the keyword PRIMARY
                  |            or SECONDARY, or a string naming the global
                  |            selection grabbed or lost.  Returns 0 if
                  |            the call has been used in the wrong context.
                  |            You must specify the keyword GLOBAL_SELECT
                  |            as the third parameter with this call.
 "global_select"  | (1 or 0) - Indicates whether VAXTPU currently owns
                  |            the specified global selection.  When
                  |            you use this request string for Parameter2,
                  |            use a third parameter to specify the
                  |            global selection about which you want
                  |            information.  The values for Parameter3
                  |            are the keyword PRIMARY, the keyword
                  |            SECONDARY, or a string naming the
                  |            global selection.
 "grab_routine"   | Program  - The program or learn sequence implementing
                  |   or       the application's global selection or
                  | Learn or 0 input focus grab routine. When you use this
                  |            request string for Parameter2, use a third
                  |            parameter to specify which grab routine
                  |            you want.  The values for Parameter3 are
                  |            the keyword GLOBAL_SELECT or the
                  |            keyword INPUT_FOCUS.  This call returns
                  |            0 if the specified grab routine does not
                  |            exist.
 "icon_name"      | String   - The string used as the layered application's
                  |            name in the DECwindows icon box.
 "input_focus"    | 1 or 0   - Indicates whether VAXTPU owns the
                  |            input focus.
 "length"         | Integer  - The current lenght of the screen (measured
                  |             in rows).
 "line_editing"   | Keyword  - Current method of line editing (insert or
                  | or 0       overstrike); 0 if none.  In the DECwindows
                  |            version of VAXTPU, this call always returns
                  |            0.
 "mouse"          | (1 or 0) - Indicates whether VAXTPU's mouse support
                  |            capability is turned on.
 "new_length"     | Integer  - The number of rows that the screen will
                  |            have after the resize action routine has
                  |            been executed.  Resize action routines
                  |            should use this length, not the current
                  |            length of the screen, to determine the
                  |            length of windows.  If used outside
                  |            a resize action routine, this length
                  |            is the same as the current length of the
                  |            screen.
 "new_width"      | Integer -  The number of columns that the screen will
                  |            have after the the resize action routine has
                  |            been executed.  Resize action routines
                  |            should use this length, not the current
                  |            length of the screen, to determine the
                  |            length of windows.  If used outside
                  |            a resize action routine, this length
                  |            is the same as the current length of the
                  |            screen.
 "old_length"     | Integer  - The length of the screen (measured in
                  |            rows) before the most recent resize
                  |            event.  This call does not return
                  |            a useful integer in the CCT version
                  |            of VAXTPU.
 "old_width"      | Integer  - The width of the screen (measured in
                  |            columns) before the most recent resize
                  |            event.  This call does not return
                  |            a useful integer in the CCT version
                  |            of VAXTPU.
 "original_length | Integer  - The length (measured in rows) that the
                  |            screen had when VAXTPU was started up.
 "original_width" | Integer  - Physical width of the screen when VAXTPU was
                  |            invoked
 "prompt_length"  | Integer  - Number of lines in the prompt area
 "prompt_row"     | Integer  - Screen line number at which the prompt area
                  |            begins
 "read_routine"   | Program    The program or learn sequence that VAXTPU
                  |   or       executes when it owns a global selection and
                  | Learn      another DECwindows application has requested
                  |   or       information about that selection.  Returns
                  | Integer    0 if no read routine exists.  When you use
                  |            this request string, use the keyword
                  |            GLOBAL_SELECT as the third parameter.
 "screen_limits"  | Array    - An integer-indexed array specifying the
                  |            minimum and maximum screen length and width.
                  |            This call signals an error in the CCT version
                  |            of VAXTPU.
 "screen_update"  | (1 or 0) - Indicates whether screen updating is turned on.
 "scroll"         | (1 or 0) - Indicates whether the terminal has scrolling
                  |            regions, DEC_CRT.
 "time"           | String   - The amount of time (in delta format)
                  |            VAXTPU will wait after requesting
                  |            information about a global selection
                  |            before assuming that the request
                  |            will not be answered.
 "ungrab_routine" | Program  - The program or learn sequence implementing
                  |   or       the application's global selection or
                  | Learn or 0 input focus ungrab routine. When you use this
                  |            request string for Parameter2, use a third
                  |            parameter to specify which ungrab routine
                  |            you want.  The values for Parameter3 are
                  |            the keyword GLOBAL_SELECT or the
                  |            keyword INPUT_FOCUS.  This call returns
                  |            0 if the specified ungrab routine does not
                  |            exist.
 "visible_length" | Integer  - Page length of the terminal
 "vt100"          | (1 or 0) - Indicates whether the terminal a VT100-series
 "vt200"          | (1 or 0) - Indicates whether the terminal a VT200-series
 "vt300"          | (1 or 0) - Indicates whether the terminal a VT300-series
 "vk100"          | (1 or 0) - Indicates whether the terminal is a GIGI
 "width"          | Integer  - Current physical width of the screen

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026