(LOGO.JPG) Python for OpenVMS

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


INSERT_CHARS - Insert Characters

Insert characters into the virtual display.

Format:

    status = vms_smg.insert_chars (display_id, character_string, \
                    start_row, start_column,                     \
                    [rendition_set], [rendition_complement],     \
                    [character_set])
Returns:
status
Condition code as returned from SMG$INSERT_CHARS. Either SS$_NORMAL or SMG$_WILUSERMS are returned here - all other codes produce a Python exception.
Arguments:
display_id
Virtual display in which to insert the characters.
character_string
The character string to be inserted.
start_row
The row position at which to begin the insertion.
start_column
The column position at which to begin the insertion.
rendition_set
Attribute specifier. Bit mask values like SMG_M_BOLD are in module 'vms_smgdef'.
rendition_complement
Attribute complement specifier. There are no symbolic names available - please see the OpenVMS documentation for details.
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 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)
>>>

>>> # put some text in the display
>>> status = vms_smg.put_chars (display_id, 'Line1Line1Line1', 1, 1)
>>> status = vms_smg.put_chars (display_id, 'Line2Line2Line2', 2, 2)
>>> status = vms_smg.put_chars (display_id, 'Line3Line3Line3', 3, 3)
>>>

Screen layout, file: VMS_SMG_015.JPG

(picture VMS_SMG_015.JPG)

>>> # insert characters in line 1
>>> vms_smg.insert_chars (display_id, 'IN1', 1, 3)
>>>

>>> # insert graphic symols in line 3
>>> vms_smg.insert_chars (display_id, 'qnqxq', 3, 4, None, None, \
...        vms_smgdef.SMG_C_SPEC_GRAPHICS)
>>>

Screen layout, file: VMS_SMG_026.JPG

(picture VMS_SMG_026.JPG)


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

11-SEP-2000 ZE.