DlgEnable Instruction/Function

Syntax:

DlgEnable DlgItem, Enable]

 

-or-

DlgEnable(DlgItem)

 

Group:

Dialog Function

Description:

 

Instruction: Enable or disable DlgItem.

Function: Return True if DlgItem is enabled.

This instruction/function must be called directly or indirectly from a dialogfunc.

 

Parameter

Description

DlgItem

If this is a numeric value then it is the dialog item number. The first item is 0, second is 1, etc. If this is a string value then it is the dialog item's field name.

Note: Use -1 to enable or disable all the dialog items at once.

default

IF this numeric value is True then enable DlgItem|$. Otherwise, disable it. If this omitted then toggle it.

 

 

Enable It this numeric value is True then enable DlgItem|$. Otherwise, disable it. If this omitted then toggle it.

 

Example:


Sub Main
  Begin Dialog UserDialog 200,120,.DialogFunc
  Text 10,10,180,15,"Please push the OK button"
  TextBox 10,40,180,15,.Text
  OKButton 30,90,60,20
  PushButton 110,90,60,20,"&Disable"
  End Dialog

  Dim dlg As UserDialog
  Debug.Print Dialog(dlg)
End
Sub


Function DialogFunc%(DlgItem$, Action%, SuppValue%)
  Debug.Print "Action=";Action%
  Select Case Action%
  Case 1 ' Dialog box initialization
  Beep
  Case 2 ' Value changing or button pressed
  Select Case DlgItem$
  Case "Disable"
  DlgText DlgItem$,"&Enable"
  DlgEnable "Text",False
  DialogFunc% = True 'do not exit the dialog
  Case "Enable"
  DlgText DlgItem$,"&Disable"
  DlgEnable "Text",True
  DialogFunc% = True 'do not exit the dialog
  End Select
End
Select
End
Function