Connect Virtual Keyboard to Process

This Subprogram allows the internal Virtual Keyboard to be connected to a Process. Subsequent calls to UI_FEED_PROCESS or to the Process Service Subprograms (described later) will direct text to the specified Process as if it had been typed at the Keyboard attached to the Process.

Short Name Calling Sequence

STATUS = UICOPC(PRCNAM)

Long Name Calling Sequence

STATUS = UI_CONNECT_PROCESS(...)

Input Arguments

PRCNAM (Character) Process Name

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_PROCESS ) Illegal Process Name UIILPC )

Note:

1. The Process Name may be truncated relative to its full name (as specified in the call to UI_DEFINE_PROCESS that created the Process) as long as it remains unambiguous. Case (upper or lower) is ignored.
2. If the Virtual Keyboard is connected to another Client Process at the time this call is made an implicit call to UI_DISCONNECT_PROCESS will be made. This will restore the Viewport associated with that Process to its state prior to the call that connected the keyboard to it. Thus, if the Viewport were hidden it will be hidden again, or its priority will be lowered to its normal value.
3. The Viewport associated with the specified Process will be ``Popped" to the front on the screen and the Label (being the Process Name) will be highlighted.