LoseFocus
PowerScript event
Description
Occurs just before a control loses focus (before it becomes
inactive).
Event ID
|
Event ID |
Description |
|---|---|
|
pbm_controltypekillfocus |
UserObject (standard visual user objects |
|
pbm_bnkillfocus |
CheckBox, CommandButton, Graph, OLE, Picture, |
|
pbm_cbnkillfocus |
DropDownListBox, |
|
pbm_dwnkillfocus |
DataWindow |
|
pbm_enkillfocus |
SingleLineEdit, EditMask, |
|
pbm_killfocus |
HProgressBar, VProgressBar, DatePicker, |
|
pbm_lbnkillfocus |
ListBox, PictureListBox |
|
pbm_lvnkillfocus |
ListView |
|
pbm_renkillfocus |
RichTextEdit |
|
pbm_sbnkillfocus |
HScrollBar, HTrackBar, VScrollBar, |
|
pbm_tcnkillfocus |
Tab |
|
pbm_tvnkillfocus |
TreeView |
|
None |
WebBrowser controls |
Arguments
None
Return Values
Long.
Return code choices (specify in a RETURN statement):
0 — Continue processing
Usage
Write a script for a control’s LoseFocus event if you want some
processing to occur when the user changes focus to another control.
For controls that contain editable text, losing focus can also cause
a Modified event to occur.
In a RichTextEdit control, a LoseFocus event occurs when the user
clicks on the control’s toolbar. The control does not actually lose
focus.
Because the MessageBox function grabs focus, you should not use it
when focus is changing, such as in a LoseFocus event. Instead, you might
display a message in the window’s title or a MultiLineEdit.
Examples
Example 1
In this script for the LoseFocus event of a SingleLineEdit sle_town,
the user is reminded to enter information if the text box is left
empty:
|
1 2 3 |
IF sle_town.Text = "" THEN st_status.Text = "You have not specified a town." END IF |
Example 2
Statements in the LoseFocus event for a DataWindow control dw_emp
can trigger a user event whose script validates the last item the user
entered.
This statement triggers the user event ue_accept:
|
1 |
dw_emp.EVENT ue_accept( ) |
This statement in ue_accept calls the AcceptText function:
|
1 |
dw_emp.AcceptText( ) |
This script for the LoseFocus event of a RichTextEdit control
performs processing when the control actually loses focus:
|
1 2 3 4 5 6 7 8 |
GraphicObject l_control // Check whether the RichTextEdit still has focus l_control = GetFocus() IF TypeOf(l_control) = RichTextEdit! THEN RETURN 0 // Perform processing only if RichTextEdit lost focus ... |
This script gets the name of the control instead:
|
1 2 3 4 |
GraphicObject l_control string ls_name l_control = GetFocus() ls_name = l_control.Classname( ) |
See also