(LOGO.JPG) Python for OpenVMS

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


CREATE_VIRTUAL_KEYBOARD - Create a Virtual Keyboard

Create a virtual keyboard and return its assigned keyboard identifier.

Format:

    keyboard_id, resultant_filespec = \
        vms_smg.create_virtual_keyboard ([input_device],
               [default_filespec], [recall_size])
Returns:
keyboard_id
The keyboard identifier of the newly created virtual keyboard.
resultant_filespec
The fully expanded file specification of the file used
Arguments:
input_device
The file specification or logical name of the file or terminal to be used for this virtual keyboard.
default_filespec
The default file specification. default_filespec might be used to specify a default device and directory, leaving the input_device argument to supply the file name and type.
recall_size
Number of input lines to be saved for later recall. Default = 20 lines.
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 keyboard -
>>> #   use the device name from CREATE_PASTEBOARD
>>> keyboard_id, resultant_filespec = \
...     vms_smg.create_virtual_keyboard (device_name)
>>>

>>> print "device_name........:", device_name
device_name........: _FTA19:
>>> print "keyboard_id........:", keyboard_id
keyboard_id........: 3133080
>>> print "resultant_filespec.:", resultant_filespec
resultant_filespec.: _FTA19:[PYTHON.PYTHON-1_5_2.VMS].;
>>>

----------------------------------------

>>> # use a non-existing device name
>>> keyboard_id, resultant_filespec = \
...     vms_smg.create_virtual_keyboard ('NOSUCHDEV:')
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_smg.error: (99524, '%RMS-F-DEV, error in device name or\
 inappropriate device type for operation')
>>>

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

10-SEP-2000 ZE.