VMS Help RTL Routines, SMG$, SMG$GET_DISPLAY_ATTR  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Get Display Attributes routine receives the attributes
    associated with a virtual display.

    Format

      SMG$GET_DISPLAY_ATTR  display-id [,height] [,width]

                            [,display-attributes] [,video-attributes]

                            [,character-set] [,flags]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 display-id

    OpenVMS usage:identifier
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Specifies the virtual display for which information is requested.
    The display-id argument is the address of an unsigned longword
    that contains the display identifier.

    The display identifier is returned by SMG$CREATE_VIRTUAL_DISPLAY.

 height

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       write only
    mechanism:    by reference

    Receives the number of rows in the display. The optional height
    argument is the address of a signed longword into which the
    height is written.

 width

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       write only
    mechanism:    by reference

    Receives the number of columns in the display. The optional
    width argument is the address of a signed longword into which
    is written the number of columns in the display.

 display-attributes

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference

    Receives the current default display attributes. The optional
    display-attributes argument is the address of an unsigned
    longword into which the current display attributes are written.

    Valid values for display-attributes are as follows:

    SMG$M_BORDER       Specifies a bordered display. If omitted, the
                       display is not bordered.
    SMG$M_BLOCK_       Specifies a block bordered display. If
    BORDER             omitted, the display is not bordered.
    SMG$M_DISPLAY_     Specifies that control characters such as
    CONTROLS           carriage return and line feed are displayed as
                       graphic characters, if your terminal supports
                       them.
    SMG$M_TRUNC_ICON   Specifies that an icon (generally a diamond
                       shape) is displayed where truncation of a line
                       exceeding the width of the virtual display has
                       occurred.

 video-attributes

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference

    Receives the current default video attributes. The optional
    video-attributes argument is the address of an unsigned longword
    into which the current video attributes are written.

    Valid video attributes are as follows:

    SMG$M_BLINK        Displays blinking characters.
    SMG$M_BOLD         Displays characters in higher-than-normal
                       intensity.
    SMG$M_REVERSE      Displays characters in reverse video; that is,
                       using the opposite of the default rendition of
                       the virtual display.
    SMG$M_UNDERLINE    Displays underlined characters.
    SMG$M_INVISIBLE    Specifies invisible characters; that is, the
                       characters exist in the virtual display but do
                       not appear on the pasteboard.
    SMG$M_USER1        Displays user-defined attributes.
    through
    SMG$M_USER8

 character-set

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference

    Receives the default character set for all text in this virtual
    display. The optional character-set argument is the address of an
    unsigned longword that specifies the character set. Valid values
    are SMG$C_ASCII (the default) and SMG$C_SPEC_GRAPHICS.

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference

    Optional bit mask specifying attributes of the specified display.
    The flags argument is the address of an unsigned longword
    containing the flag. Valid values for flags are as follows:

    SMG$M_SUBPROCESS   Display has a subprocess attached to it.
    SMG$M_MENU         Display contains a menu.
    SMG$M_VIEWPORT     Display contains a viewport.