IAgentNotifySink::Click

[Microsoft Agent is deprecated as of Windows 7, and may be unavailable in subsequent versions of Windows.]

HRESULT Click(
   long dwCharID,  // character ID
   short fwKeys,   // mouse button and modifier key state
   long x,         // x coordinate of mouse pointer
   long y          // y coordinate of mouse pointer
);                          

Notifies a client application when the user clicks a character or character's taskbar icon.

• No return value.

dwCharID

Identifier of the clicked character.

fwKeys

A parameter that indicates the mouse button and modifier key state. The parameter can return any combination of the following:

Value	Description
0x0001	Left Button
0x0010	Middle Button
0x0002	Right Button
0x0004	Shift Key Down
0x0008	Control Key Down
0x0020	Alt Key Down
0x1000	Event occurred on the character's taskbar icon

 

x

The x-coordinate of the mouse pointer in pixels, relative to the screen origin (upper left).

y

The y-coordinate of the mouse pointer in pixels, relative to the screen origin (upper left).

This event is sent to the input-active client of the character. If none of the character's clients are input-active, the server notifies the character's active client. If the character is visible, the server also makes that client input-active and sends the IAgentNotifySink::ActivateInputState. If the character hidden, the character is also automatically shown.