Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlVm_UIEmuSendClick Function
PHT_VIRTUAL_MACHINE

Send mouse click event to User Input Emulation.

Syntax
PRL_RESULT PrlVm_UIEmuSendClick(
    PRL_HANDLE hVm, 
    PRL_INT32 posX, 
    PRL_INT32 posY, 
    PRL_UINT32 count, 
    PRL_UINT32 button
);
File

PrlApiVm.h

Parameters

hVm
[in] Handle of type PHT_VIRTUAL_MACHINE. Must be valid.
posX
[in] x coordinate within guest screen.
posY
[in] y coordinate within guest screen.
count
[in] Click count. One of PRL_UIEMU_MOUSE_CLICK.
button
[in] Mouse button identifier. See the PRL_MOUSE_BUTTON enumeration for available choices. Don't use PMB_NOBUTTON, because in this case no button to click.

Returns

PRL_RESULT. Possible values: 

PRL_ERR_INVALID_ARG - invalid handle. PRL_ERR_SUCCESS - function completed successfully. 

Remarks

Click mouse button at the specified absolute position. 

Since not all versions of User Input Emulation tool support this request and not all guest OS can supply required functionality, use TIS uuid TIS_UID_UIEMU_GUEST_CROSS_CLICK ("parallels.UserInputEmulation.guest.cross.Click") to get status of that feature. If this uuid is in active state in TIS database, this function can be used.

Links
© 2021 Parallels International GmbH. All rights reserved.