9.0

141
dialogfunc definition
A dialog function executes while a UserDialog is visible.
DialogFunc Prototype
Syntax
Function dialogfunc(DlgItem$, Action%, SuppValue%) _
As Boolean
Select
Case Action%
Case 1 ' Dialog
box initialization
...
Case 2 ' Value changing or button pressed
...
Case 3 ' TextBox
or ComboBox text changed
...
Case 4 ' Focus changed
...
Case 5 ' Idle
...
Case 6 ' Function
key
...
End Select
End
Function
Group
Dialog Function
Description
A dialogfunc implements the dynamic dialog capabilities.
Parameter Description
DlgItem This string value is the name of the user dialog item's field.
Action This numeric value indicates what action the dialog function is being asked to do.
SuppValue This numeric value provides additional information for some actions.
Action/Description
Dialog box initialization. DlgItem is a null string. SuppValue is the dialog's window handle. Set dialogfunc =
True
to terminate the dialog.
CheckBox, DropListBox, ListBox, MultiListBox, or OptionGroup: DlgItem's value has changed. SuppValue is
the new value.
CancelButton
, OKButton or PushButton: DlgItem's button was pushed. SuppValue is meaningless. Set
dialogfunc
= True to prevent the dialog from closing.
ComboBox or TextBox: DlgItem's text changed and losing focus. SuppValue is the number of characters.
Item DlgItem is gaining focus. SuppValue is the item that is losing focus. (The first item is 0, second is 1,
etc.)
Idle processing. DlgItem is a null string. SuppValue is zero. Set dialogfunc = True to continue receiving idle
actions.
Function key (F1-F24) was pressed. DlgItem has the focus. SuppValue is the function key number and the