(LOGO.JPG) Python for OpenVMS

(go to: table of contents, index, list of vms_smg, prev: PREV, next: CHANGE_RENDITION)


CHANGE_PBD_CHARACTERISTICS - Change Pasteboard Characteristics

Changes the characteristics associated with a pasteboard.

Format:

    width, height, background_color =                      \
        vms_smg.change_pbd_characteristics (pasteboard_id, \
            [desired_width], [desired_height],             \
            [desired_background_color])
Returns:
width
The physical width of the pasteboard.
height
The physical height of the pasteboard.
background_color
The background color chosen or SMG_C_COLOR_UNKNOWN.
Arguments:
pasteboard_id
The pasteboard whose characteristics are to be changed.
desired_width
New width for the pasteboard.
desired_height
New height for the pasteboard.
desired_background_color
Symbolic name for the desired background color. Constants like SMG_C_COLOR_BLUE 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)
>>>
Screen layout

(picture VMS_SMG_012.JPG)

>>> # change pasteboard characteristics
>>> width, height, background_color =                      \
        vms_smg.change_pbd_characteristics (pasteboard_id, \
        20, 5, vms_smgdef.SMG_C_COLOR_BLUE)
>>>
>>> print width, height, background_color
20 5 3
>>> print vms_smgdef.SMG_C_COLOR_BLUE
3
>>>
Screen layout

(picture VMS_SMG_013.JPG)

>>> # try to change the characteristics of a non-existing pasteboard
>>> status = vms_smg.change_pbd_characteristics \
...          (pasteboard_id+99, 5, 5)
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: PREV, next: CHANGE_RENDITION)

02-JUL-2000 ZE.