FocusOnClick (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Special cases
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

FocusOnClick (Property)

In french: FocusAuClic

The FocusOnClick property is used to:

Determine if a control gains focus when clicked.
Allow or prevent a control from gaining focus when clicked.

Remarks:

Controls without "focus on click" do not keep the focus. After a click, the focus is given back to the control that was previously used. The exit code of these controls is not run.
By default, all the controls have the "focus on click" except for the Interruption buttons.
This property is only available for Button controls.

Example

// Determine whether the Check Box control gains focus when clicked
IF CBOX_Settings.FocusOnClick = True THEN
	Info("After a click, the check box keeps focus.")
ELSE
	Info("After a click, the check box gives focus back to the previous control.")
END

// Removes the focus when "CBOX_Settings" is clicked if this control keeps focus
IF CBOX_Settings.FocusOnClick = True THEN
	CBOX_Settings.FocusOnClick = False
END

Syntax

Determining if a control gains focus when clicked Hide the details

<Result> = <Control used>.FocusOnClick

<Result>: Boolean

True if the element gains focus when clicked,
False otherwise.

<Control used>: Control name

Name of the control used.

Modifying how a control gains focus Hide the details

<Control used>.FocusOnClick = <With focus/Without focus>

<Control used>: Control name

Name of the control used.

<With focus/Without focus>: Boolean

True if the control must gain focus when clicked,
False if the previous control must keep the focus.

Remarks

Special cases

Regardless of the value of the FocusOnClick property, the focus can be set to the control using one of the following functions:
If the control is accessible via the Tab key, it can gain focus during navigation, regardless of the value of the FocusOnClick property.

Limitations

The FocusOnClick property can only be used in the following controls:

Buttons.
Check boxes.
List boxes.
Images.
Tabs.
Tables.
Treeview tables.

The FocusOnClick property applies only to Button controls.