ControlSetChecked

Turns on (checks) or turns off (unchecks) a checkbox or radio button.

ControlSetChecked Value, Control , WinTitle, WinText, ExcludeTitle, ExcludeText

Parameters

Value

Type: Integer

One of the following values:

Control

Type: String, Integer or Object

The control's ClassNN, text or HWND, or an object with a Hwnd property. For details, see The Control Parameter.

WinTitle

Type: String, Integer or Object

A window title or other criteria identifying the target window. See WinTitle.

WinText

Type: String

If present, this parameter must be a substring from a single text element of the target window (as revealed by the included Window Spy utility). Hidden text elements are detected if DetectHiddenText is ON.

ExcludeTitle

Type: String

Windows whose titles include this value will not be considered.

ExcludeText

Type: String

Windows whose text include this value will not be considered.

Error Handling

A TargetError is thrown if the window or control could not be found.

An OSError is thrown if a message could not be sent to the control.

Remarks

To ensure correct functionality, this function also sets the input focus to the control.

To improve reliability, a delay is done automatically after each use of this function. That delay can be changed via SetControlDelay or by assigning a value to A_ControlDelay. For details, see SetControlDelay remarks.

Window titles and text are case sensitive. Hidden windows are not detected unless DetectHiddenWindows has been turned on.

ControlGetChecked, Value property (GuiControl object), Control functions