(LOGO.JPG) Python for OpenVMS

(go to: table of contents, index, list of vms_smg, prev: CHANGE_VIEWPORT, next: CHECK_FOR_OCCLUSION)


CHANGE_VIRTUAL_DISPLAY - Change Virtual Display

Change characteristics (dimensions, border, video rendition) of a virtual display. Use vms_smg.repaste_virtual_display to change the location and pasting order of the display within the pasteboard. Use vms_smg.move_virtual_display to change the location, but keep the pasting order.

Format:

    vms_smg.change_virtual_display (display_id, \
            [number_of_rows], [number_of_columns], \
            [display_attributes], [video_attributes], \
            [character_set])
Returns:

None

Arguments:

display_id
Virtual display to be changed.
number_of_rows
The new number of rows.
number_of_columns
The new number of columns.
display_attributes
Bitmasks like SMG_M_BORDER for the attributes of the virtual display are in module 'vms_smgdef'.
video_attributes
The new default rendition set for all output to this virtual display. Bitmasks like SMG_M_BLINK are in module 'vms_smgdef'.
character_set
The new default character set for all text in this virtual display. Constants like SMG_C_ASCII are in module 'vms_smgdef'.
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

(picture VMS_SMG_001.JPG)

>>> # now CHANGE the virtual display
>>> vms_smg.change_virtual_display \
...         (display_id, 7, 5, vms_smgdef.SMG_M_BLOCK_BORDER)
>>>

Screen layout

(picture VMS_SMG_002.JPG)

Notice that the display is at the same location, but its dimensions have changed and it now has a block border.


(go to: table of contents, index, list of vms_smg, prev: CHANGE_VIEWPORT, next: CHECK_FOR_OCCLUSION)

02-JUL-2000 ZE.