(LOGO.JPG) Python for OpenVMS

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


BEGIN_PASTEBOARD_UPDATE - Begin Batching of Pasteboard Updates

Saves, or batches, all output to a pasteboard until a matching call to vms_smg.end_pasteboard_update() is encountered.

Format:

    vms_smg.begin_pasteboard_update (pasteboard_id)
Returns:

None

Arguments:

pasteboard_id
Pasteboard for which output is to be batched.
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)
>>>

Notice that an empty screen as been created.

>>> # start batching of the pasteboard
>>> vms_smg.begin_pasteboard_update (pasteboard_id)

>>> # 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
>>> vms_smg.put_chars (vtdpy1, 'V1', 0, 0)
>>>

>>> # paste virtual display 1
>>> status = vms_smg.paste_virtual_display \
...         (vtdpy1, pasteboard_id, 3, 5, None)
>>> print status
1212457
>>>
>>> import vms_sys
>>> print vms_sys.getmsg (status)
('%SMG-S-BATWAS_ON, batching was on', (0, 0, 0, 0))
>>>

Notice that the screen has not changed.

>>> # 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
>>> vms_smg.put_chars (vtdpy2, 'V2', 0, 0)
>>>

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

Notice that the screen still has not changed.

>>> # end updates
>>> status = vms_smg.end_pasteboard_update (pasteboard_id)

Screen layout

(picture VMS_SMG_003.JPG)


Notice that the virtual displays are now visible.

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

02-JUL-2000 ZE.