Please enable JavaScript to view this site.

A-Shell Development History

TabX enhancement: CTLOP_PANE now supports one-step panel switch, with optional save/restore. It is essential that you use CTLOP_PANE to switch panels, but CTLOP_CLR is no longer needed.

Syntax review:

xcall AUI, AUI_CONTROL, CTLOP_PANE, tabid$, paneid$, cstate, NUL_CTYPE, NUL_CMD$, NUL_FUNC$, status

if status <= 0 then   ! if no controls restored <(re)create the controls for the new panel>

endif

 

where:

paneid$ (string) identifies the panel to switch to, either its command string (e.g. "VK_xF302"), or the panel number as a string (e.g. str(2)), or the panel label text (e.g. "&History").

cstate (b,4) may specify the optional flag MBST_SAVRES (&h80000000) in which case the current panel's controls will be saved, and if there is a previously saved set of controls for the new panel, it will be restored (and the number of restored controls will be returned in the status parameter, allowing you to conditionally recreate the controls). For backwards compatibility, if paneid$ = "", you can specify the new panel number in the low word of the cstate parameter.

Note: Since the MBST_SAVRES flag signals both the save operation (for the current panel) and the restore operation (for the new panel), if you only want one of the operations, you'll have to use the two step method (CTLOP_CLR followed by CTLOP_PANE) so that you can specify the MBST_SAVRES flag on just the one operation.