Syntax 2: For all other controls
Description
Occurs when the contents in the control have changed.
Event ID
|
Event ID |
Objects |
|---|---|
|
pbm_cbnmodified |
DropDownListBox, |
|
pbm_enmodified |
SingleLineEdit, EditMask, |
|
pbm_inkemodified |
InkEdit |
|
pbm_renmodified |
RichTextEdit |
Arguments
None
Return Values
Long.
Return code choices (specify in a RETURN statement):
0 — Continue processing
Usage
For plain text controls, the Modified event occurs when the user
indicates being finished by pressing Enter or tabbing away from the
control.
For InkEdit and RichText Edit controls, the value of the Modified
property controls the Modified event. If the property is false, the
event occurs when the first change occurs to the contents of the
control. The change also causes the property to be set to true, which
suppresses the Modified event. You can restart checking for changes by
setting the property back to false.
Resetting the Modified property is useful when you insert text or
a document in the control, which triggers the event and sets the
property (it is reporting the change to the control’s contents). To find
out when the user begins making changes to the content, set the Modified
property back to false in the script that opens the document. When the
user begins editing, the property will be reset to true and the event
will occur again.
A Modified event can be followed by a LoseFocus event.
Examples
In this example, code in the Modified event performs validation on
the text the user entered in a SingleLineEdit control sle_color. If the
user did not enter RED, WHITE, or BLUE, a message box indicates what is
valid input; for valid input, the color of the text changes:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
string ls_color This.BackColor = RGB(150,150,150) ls_color = Upper(This.Text) CHOOSE CASE ls_color CASE "RED" This.TextColor = RGB(255,0,0) CASE "BLUE" This.TextColor = RGB(0,0,255) CASE "WHITE" This.TextColor = RGB(255,255,255) CASE ELSE This.Text = "" MessageBox("Invalid input", & "Enter RED, WHITE, or BLUE.") END CHOOSE |
This is not a realistic example: user input of three specific
choices is more suited to a list box; in a real situation, the allowed
input might be more general.
See also