单击事件
[自 Windows 7 起弃用 Microsoft Agent,在后续版本的 Windows 中可能不可用。]
-
描述
-
当用户单击字符或字符图标时发生。
-
语法
-
Sub agent**_Click** (ByVal CharacterID, ByVal Button, ByVal Shift, ByVal X, ByVal Y**)**
组成部分 说明 CharacterID 以字符串形式返回单击字符的 ID。 按钮 返回一个整数,该整数标识按下和释放导致事件的按钮。 按钮参数是位域,位对应于左按钮(位 0)、右按钮(位 1)和中间按钮(位 2)。 这些位分别对应于值 1、2 和 4。 仅其中一个位被设置,表示引起事件的按钮。 如果字符包含任务栏图标,并且还设置了位 13,则单击发生在任务栏图标上。 Shift 返回一个整数,该整数对应于按下或释放按钮参数中指定的按钮时 SHIFT、Ctrl 和 Alt 键的状态。 如果按键被按下,则设置位。 Shift 参数是一个位域,其最小有效位对应于 SHIFT 键(位 0)、CTRL 键(位 1)和 ALT 键(位 2)。 这些位分别对应于值 1、2 和 4。 shift 参数表示这些键的状态。 可以设置部分、全部或不设置任何位,表示按下了部分、全部或未按下任何键。 例如,如果同时按下 Ctrl 和 ALT,则 Shift 的值为 6。 X、Y 返回一个整数,指定鼠标指针的当前位置。 相对于屏幕左上角,X 和 Y 值始终以像素表示。
注解
此事件仅发送到字符的输入活动客户端。 当用户在没有输入活动客户端的情况下单击字符或其任务栏图标时,服务器会将事件发送到其活动客户端。 如果该字符可见 (Visible = True),则用户的操作还将字符的最后一个输入活动客户端设置为当前输入活动客户端,将 ActivateInput 事件发送到该客户端,然后发送 Click 事件。 如果该字符处于隐藏状态 (Visible = False),并且用户使用按钮 1 单击该字符的任务栏图标,则该字符也会自动显示。
注意
单击字符不会禁用所有其他字符输出(所有字符)。 但是,按下 Listening 键会刷新输入活动字符的输出并触发 RequestComplete 事件,并传递一个 Request.Status,指示客户端的队列已中断。