CONTEXT Mnemonic - Set SYSGUI Device Context

Syntax

'CONTEXT'(num)

Description

The 'CONTEXT' mnemonic sets the current context ID to num. Each graphical window created with the SYSGUI device must have its own context. With a device context, SYSGUI can be used to communicate with multiple windows simultaneously. The SYSGUI device maintains a current context and is used to specify which window is being referenced. While some operations require that a context be specified as a parameter, most operate on the current context.

The context ID is an integer from 0 to 32767. When SYSGUI is first opened, the current context ID is 0, (empty, or no window in this context). All contexts are initially empty and context 0 is selected as current. The CTRL() and FIN() functions can be used to report the current context, the number of an unused context, and the number of active contexts.

If only one graphical window is created at a time, the context does not need to be set. However, to create multiple windows and manipulate them simultaneously, contexts must be switched. Set the current context by issuing 'CONTEXT'(num) to the SYSGUI channel.

Parameter

Description

num

Context ID number. It must be an integer between 0 and 32767.

See Also

Mnemonics - Alphabetical Listing

Mnemonics - Group Listing



______________________________________________________________________________________

Copyright BASIS International Ltd. BBj®, Visual PRO/5®, PRO/5®, and BBx® are registered trademarks.