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

    The Move Text from One Virtual Display to Another routine moves
    a rectangle of text from one virtual display to another virtual
    display. Given two points in opposite corners of the rectangle,
    SMG$MOVE_TEXT determines the desired width and height of the new
    virtual display.

    Format

      SMG$MOVE_TEXT  display-id ,top-left-row ,top-left-column

                     ,bottom-right-row ,bottom-right-column

                     ,display-id2 [,top-left-row2]

                     [,top-left-column2] [,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 from which text is to be moved. 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.

 top-left-row

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

    Top left row of the rectangle of text you want to move. The
    top-left-row argument is the address of an unsigned longword
    containing the row number.

 top-left-column

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

    Top left column of the rectangle of text you want to move. The
    top-left-column argument is the address of an unsigned longword
    containing the column number.

 bottom-right-row

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

    Bottom right row of the rectangle of text you want to move. The
    bottom-right-row argument is the address of an unsigned longword
    containing the row number.

 bottom-right-column

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

    Bottom right column of the rectangle of text you want to move.
    The bottom-right-column argument is the address of an unsigned
    longword containing the column number.

 display-id2

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

    Specifies the virtual display to which the text is to be moved.
    The display-id2 argument is the address of an unsigned longword
    that contains the display identifier.

    The display identifier display-id2 is returned by SMG$CREATE_
    VIRTUAL_DISPLAY.

 top-left-row2

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

    Top left row of the rectangle that is the destination of the
    text you want to move. The optional top-left-row2 argument is the
    address of an unsigned longword containing the row number. If you
    do not specify a value for top-left-row2, the text is moved to
    the current virtual cursor row.

 top-left-column2

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

    Top left column of the rectangle that is the destination of the
    text you want to move. The optional top-left-column2 argument is
    the address of an unsigned longword containing the column number.
    If you do not specify a value for top-left-column2, the text is
    moved to the current virtual cursor column.

 flags

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

    Optional bit mask that specifies the action to take when moving
    the specified text. The flags argument is the address of an
    unsigned longword that contains the flag. The flags argument
    accepts the following values:

    SMG$M_TEXT_SAVE    Does not erase the text after moving.
    SMG$M_TEXT_ONLY    Moves the text but not the attributes.