# ControlGetFocus

如果有, 则获取目标窗口中具有输入焦点的控件.

    HWND := ControlGetFocus(WinTitle, WinText, ExcludeTitle, ExcludeText)

## 参数

WinTitle

  类型: 字符串, 整数或对象

  识别目标窗口的窗口标题或其他条件. 请参阅 WinTitle.

WinText

  类型: 字符串

  如果存在, 此参数必须是目标窗口的单个文本元素的子字符串(和内置的 Window Spy 工具显示的一样). 如果 DetectHiddenText 为 ON, 那么会检测隐藏文本元素.

ExcludeTitle

  类型: 字符串

  标题中含有此参数值的窗口将被排除.

ExcludeText

  类型: 字符串

  文本中含有此参数值的窗口将被排除.

## 返回值

类型: 整数

此函数返回具有输入焦点的控件的窗口句柄(HWND).

如果目标窗口的控件都没有焦点, 则返回 0.

## 错误处理

如果在确定目标窗口或控件时出现问题, 则抛出 TargetError.

如果在确定焦点时出现问题, 则抛出 OSError.

## 备注

通过此函数检索的控件是具有键盘焦点的控件, 即, 如果用户键入任何键盘, 将接收击键的控件.

目标窗口必须处于活动状态才能具有焦点控件, 但是即使是活动窗口也可能没有焦点控件.

窗口标题和文本是区分大小写的. 除非 DetectHiddenWindows 被打开, 否则不会检测隐藏窗口.

## 相关

ControlFocus, Control 函数

## 示例

报告活动窗口的焦点控件的 HWND 和 ClassNN.

    FocusedHwnd := ControlGetFocus("A")
    FocusedClassNN := ControlGetClassNN(FocusedHwnd)
    MsgBox 'Control with focus = {Hwnd: ' FocusedHwnd ', ClassNN: "' FocusedClassNN '"}'

dftg