(LOGO.JPG) Python for OpenVMS

(go to: table of contents, index, list of vms_smg, prev: LIST_PASTEBOARD_ORDER, next: NEXT)


LIST_PASTING_ORDER - Return Virtual Display Pasting Information

Return the identifiers of the virtual displays pasted to a specified pasteboard. Also, the pasteboard row 1 and column 1 (origins) of the virtual displays are also returned.

Format:

    status, context, display_id,        \
    pasteboard_row, pasteboard_column = \
        vms_smg.list_pasting_order (pasteboard_id, context)
Returns:
status
Condition code as returned from SMG$LIST_PASTING_ORDER. Either SS$_NORMAL or SMG$_NOTPASTED are returned here - all other codes produce a Python exception.
context
Search context - see the OpenVMS documentation for details.
display_id
The identifier of the display that is pasted.
pasteboard_row
Row of the pasteboard that contains row 1 of this virtual display.
pasteboard_column
Column of the pasteboard that contains column 1 of this virtual display.
Arguments:
pasteboard_id
Identifier of the pasteboard on which the virtual display(s) is/are pasted.
context
Search context - see the OpenVMS documentation for details.
Examples:
>>> import vms_smg
>>> import vms_smgdef
>>> import vms_sys

>>> # create a new DECwindows terminal using SMG
>>> status, pasteboard_id, number_of_pasteboard_rows, \
... number_of_pasteboard_columns, type_of_terminal,   \
... device_name = vms_smg.create_pasteboard           \
...   (None, vms_smgdef.SMG_M_WORKSTATION)
>>>

>>> # create virtual display 1
>>> status, vtdpy1 = vms_smg.create_virtual_display \
...         (5, 10, vms_smgdef.SMG_M_BORDER, None, None)
>>>

>>> # write to virtual display 1
>>> status = vms_smg.put_chars (vtdpy1, 'V1', 0, 0)
>>>

>>> # create virtual display 2
>>> status, vtdpy2 = vms_smg.create_virtual_display \
...         (5, 10, vms_smgdef.SMG_M_BORDER, None, None)
>>>

>>> # write to virtual display 2
>>> status = vms_smg.put_chars (vtdpy2, 'V2', 0, 0)
>>>

>>> # paste virtual display 1
>>> status = vms_smg.paste_virtual_display \
...          (vtdpy1, pasteboard_id, 3, 5, None)
>>>

>>> # paste virtual display 2
>>> status = vms_smg.paste_virtual_display \
...          (vtdpy2, pasteboard_id, 5, 7, None)
>>>

Screen layout, file: VMS_SMG_003.JPG

(picture VMS_SMG_003.JPG)

>>> # check pasteboard
>>> status, context, display_id,        \
... pasteboard_row, pasteboard_column = \
...     vms_smg.list_pasting_order (pasteboard_id, 0)
>>>
>>> print vms_sys.getmsg (status)[0]
%SYSTEM-S-NORMAL, normal successful completion
>>> print context, display_id, vtdpy1
3007944 3007424 3007424
>>> print pasteboard_row, pasteboard_column
3 5
>>>

>>> # check if more virtual displays are pasted to this pasteboard
>>> #   (the updated context is used)
>>> status, context, display_id, \
... pasteboard_row, pasteboard_column = \
...     vms_smg.list_pasting_order (pasteboard_id, context)
>>>
>>> print vms_sys.getmsg (status)[0]
%SYSTEM-S-NORMAL, normal successful completion
>>> print context, display_id, vtdpy2
3006216 3007584 3007584
>>> print pasteboard_row, pasteboard_column
5 7
>>>

>>> # check if more virtual displays are pasted to this pasteboard
>>> #   (the updated context is used)
>>> status, context, display_id, \
... pasteboard_row, pasteboard_column = \
...     vms_smg.list_pasting_order (pasteboard_id, context)
>>>
>>> print vms_sys.getmsg (status)[0]
%SMG-F-NOTPASTED, given display is not pasted to given pasteboard
>>> print context, display_id
0 0
>>> print pasteboard_row, pasteboard_column
0 0
>>>

(go to: table of contents, index, list of vms_smg, prev: LIST_PASTEBOARD_ORDER, next: NEXT)

10-SEP-2000 ZE.