CONTROL SHOW STATE statement

Purpose

Change the visible state of a control.

Syntax

CONTROL SHOW STATE hDlg, id&, showstate& [TO lResult&]

Remarks

CONTROL SHOW STATE is used to alter the state and/or appearance of the specified control, identified by the parent dialog handle  hDlg, and control id& unique identifier combination.

showstate& can be one of the following (with a value in the range from 0 to 10) as defined in the WIN32API.INC file):

%SW_HIDE

Hide the control.

%SW_MAXIMIZE

Maximize the specified control.

%SW_MINIMIZE

Minimize the specified control.

%SW_RESTORE

Activate and display the control. If the control is minimized or maximized, Windows restores it to its original size and position. An application should specify this flag when restoring a minimized control.

%SW_SHOW

Activate the control and display it in its current size and position.

%SW_SHOWMAXIMIZED

Synonym of %SW_MAXIMIZE.

%SW_SHOWMINIMIZED

Activate the control and minimize it.

%SW_SHOWNA

Display the control in its current state without activating it. The currently active window/control remains active.

%SW_SHOWNOACTIVATE

Display the control in its most recent size and position without activating it. The currently active window/control remains active.

%SW_SHOWNORMAL

Activate and display the control. If the control is minimized or maximized, it is restored it to its original size and position.

If the optional TO clause is included, the lResult& variable is assigned the value zero if the control was previously not visible, or non-zero if it was previously visible.

See also

Dynamic Dialog Tools, CONTROL DISABLE, CONTROL ENABLE, DIALOG SHOW STATE