IUIAutomationTransformPattern::Rotate Method

Rotates the UI Automation element.

Syntax

HRESULT Rotate(      
    double degrees
);

Parameters

  • degrees
    [in] The number of degrees to rotate the element. A positive number rotates clockwise; a negative number rotates counterclockwise.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

An object cannot be moved, resized, or rotated such that its resulting screen location would be completely outside the coordinates of its container and inaccessible to the keyboard or mouse. For example, when a top-level window is moved completely off-screen or a child object is moved outside the boundaries of the container's viewport, the object is placed as close to the requested screen coordinates as possible with the top or left coordinates overridden to be within the container boundaries.