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