(LOGO.JPG) Python for OpenVMS

(go to: table of contents, index, list of vms_smg, prev: NAME_TO_KEYCODE, next: POP_VIRTUAL_DISPLAY)


PASTE_VIRTUAL_DISPLAY - Paste a Virtual Display

Paste a virtual display to a pasteboard.

Format:

    status = vms_smg.paste_virtual_display (display_id, pasteboard_id,\
             [pasteboard_row], [pasteboard_column], [top_display_id])
Returns:
status
Condition code as returned from SMG$PASTE_VIRTUAL_DISPLAY. Either SS$_NORMAL or SMG$_BATWAS_ON are returned here - all other codes produce a Python exception. (The latter code is not mentioned in the documentation of OpenVMS VAX V6.1).
Arguments:
display_id
Virtual display to be pasted.
pasteboard_id
Pasteboard to which the virtual display is to be pasted.
pasteboard_row
Specifies the row of the pasteboard that is to contain row 1 of the specified virtual display.
pasteboard_column
Specifies the column of the pasteboard that is to contain column 1 of the specified virtual display.
top_display_id
Identifier of the virtual display under which to paste 'display_id'. The top_display must already be pasted.
Examples:
>>> import vms_smg
>>> import vms_smgdef

>>> # 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 a virtual display
>>> status, display_id = vms_smg.create_virtual_display \
...         (5, 10, vms_smgdef.SMG_M_BORDER, None, None)
>>>

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

Screen layout, file: VMS_SMG_001.JPG

(picture VMS_SMG_001.JPG)

>>> # it appears possible to re-paste an already pasted display
>>> status = vms_smg.paste_virtual_display \
...          (display_id, pasteboard_id, 3, 15, None)
>>>

Notice that the display has moved to the right.

----------------------------------------

>>> status = vms_smg.paste_virtual_display (99, 299)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_smg.error: (1212956, '%SMG-F-INVDIS_ID, invalid display-id')
>>>

>>> status = vms_smg.paste_virtual_display (display_id, 299)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_smg.error: (1212964, '%SMG-F-INVPAS_ID, invalid pasteboard-id')
>>>

(go to: table of contents, index, list of vms_smg, prev: NAME_TO_KEYCODE, next: POP_VIRTUAL_DISPLAY)

10-SEP-2000 ZE.