(LOGO.JPG) Python for OpenVMS

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


CREATE_VIRTUAL_DISPLAY - Create a Virtual Display


Create a virtual display and returns its assigned display identifier.


Format:

    status, display_id = vms_smg.create_virtual_display \
        (number_of_rows, number_of_columns,
        [display_attributes], [video_attributes], [character_set])
Returns:
status
The condition value as returned by SMG$CREATE_VIRTUAL_DISPLAY. Any code other than SS$_NORMAL and SMG$_PASALREXI results in a Python exception.
display_id
The identifier of the newly created display.
Arguments:
number_of_rows
Height of the display.
number_of_columns
Width of the display.
display_attributes
Default display attributes.
Bitmask values like SMG_M_BORDER are defined in module 'vms_smgdef'.
video_attributes
The default rendition to be applied to all output in this virtual display unless overridden by a call.
Bitmask values like SMG_M_BLINK are defined in module 'vms_smgdef'.
character_set
The default character set for all text. Constants like SMG_C_ASCII are in module 'vms_smgdef'.
Examples:
>>> import vms_smg
>>> import vms_smgdef

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

>>> print "status.....:", status
status.....: 1
>>> print "display_id.:", display_id
display_id.: 3131200
>>>

----------------------------------------
The display is not immediately visible. See the examples section of the vms_smg.paste_virtual_display routine for a complete working demonstration.


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

30-MAY-2000 ZE.