DlgVisible, DlgVisible()

Syntax

DlgVisible Identifier[$] [On]

DlgVisible FirstIdentifier[$] LastIdentifier[$]On

DlgVisible(Identifier[$])

Remarks

In Windows 3.x, the DlgVisible statement is used in a dialog function to make visible or to hide the dialog box control identified by Identifier[$]. On the Macintosh and in Windows 95 and Windows NT, the DlgVisible statement can be used to make visible or to hide a range of dialog box controls. You can use DlgVisible to hide little-used options until they are needed, or to create dialog boxes with multiple panels of controls.

Argument

Explanation

Identifier[$]

The string or numeric identifier of the dialog box control

FirstIdentifier[$]

The string or numeric identifier of the first dialog box control in a range of dialog box controls

LastIdentifier[$]

The string or numeric identifier of the last dialog box control in a range of dialog box controls. LastIdentifier[$] can be the same as FirstIdentifier[$].

On

Shows or hides the dialog box control Identifier[$] or the range of dialog box controls between FirstIdentifier[$] and LastIdentifier[$] as listed in a dialog box definition.

1 Shows the control or range of controls

0 (zero) Hides the control or range of controls

Omitted Toggles the control between visible and hidden

Note that the On argument cannot be omitted if FirstIdentifier[$] and LastIdentifier[$] are specified.


The DlgVisible() function returns the following values:

Value

Explanation

–1

If the control is visible

0 (zero)

If the control is hidden


For an example that uses DlgVisible, see DlgText.

See Also

DlgEnable, DlgFocus, DlgText