DataWindow.ControlFocusChange Method | |
Provide a method that is invoked when the input focus changes to or from a control.
Namespace:
VO
Assembly:
VOGUIClasses (in VOGUIClasses.dll) Version: 2.21
Syntax VIRTUAL METHOD ControlFocusChange(
oControlFocusChangeEvent
) AS USUAL CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public virtual Usual ControlFocusChange(
Usual oControlFocusChangeEvent = default
)
Request Example
View SourceParameters
- oControlFocusChangeEvent (Optional)
- Type: Usual
The ControlFocusChangeEvent object that identifies which control generated the ControlFocusChangeEvent object and whether it has just gained or lost the keyboard focus.
Return Value
Type:
UsualRemarks
If ControlFocusChange() is used to validate a control (and also set the focus to another control),
Control:SetFocus() should not be called until another control has received the focus.
In complex dialog windows that contain many edit controls, it makes sense to grab the edit
control's text when the focus is changing so that other controls can be updated with it if necessary.
See the ButtonClick() method for an example of similar syntax to be used in this method.
Note that all controls are passed through this method, not only SingleLineEdit and MultiLineEdit controls.
If looking to control Combobox selections, then the ListBoxSelect() callback method should be reviewed.
See Also