ITransformProvider ITransformProvider ITransformProvider Interface

Exposes methods and properties to support access by a Microsoft UI Automation client to controls or elements that can be moved, resized, or rotated within a two-dimensional space. Implement this interface in order to support the capabilities that an automation client requests with a GetPattern(PatternInterface) call and PatternInterface.

Syntax

Declaration

public interface ITransformProviderpublic interface ITransformProviderPublic Interface ITransformProvider

Remarks

This pattern has guidelines and conventions that aren't fully documented here. For more info on what this pattern is for, see Transform Control Pattern.

ITransformProvider isn't implemented by any existing Windows Runtime automation peers. The interface exists so that custom control authors can support the automation pattern in a custom control, and implement their automation support using the same Windows Runtime managed or C++ API as they use to define control logic or other automation support.

Use the TransformPatternIdentifiers class if you want to reference the ITransformProvider pattern properties from control code when you call RaisePropertyChangedEvent(AutomationProperty, Object, Object).

Properties summary

Gets a value that indicates whether the element can be moved.

Gets a value that indicates whether the element can be resized.

Gets a value that indicates whether the element can be rotated.

Methods summary

Moves the control.

Resizes the control.

Rotates the control.

Properties

  • CanMove
    CanMove
    CanMove
    CanMove

    Gets a value that indicates whether the element can be moved.

    public bool CanMove { get; }public bool CanMove { get; }Public ReadOnly Property CanMove As boolpublic bool CanMove { get; }

    Property Value

    • bool
      bool
      bool

      true if the element can be moved; otherwise, false.

  • CanResize
    CanResize
    CanResize
    CanResize

    Gets a value that indicates whether the element can be resized.

    public bool CanResize { get; }public bool CanResize { get; }Public ReadOnly Property CanResize As boolpublic bool CanResize { get; }

    Property Value

    • bool
      bool
      bool

      true if the element can be resized; otherwise, false.

  • CanRotate
    CanRotate
    CanRotate
    CanRotate

    Gets a value that indicates whether the element can be rotated.

    public bool CanRotate { get; }public bool CanRotate { get; }Public ReadOnly Property CanRotate As boolpublic bool CanRotate { get; }

    Property Value

    • bool
      bool
      bool

      true if the element can be rotated; otherwise, false.

Methods

  • Move(Double, Double)
    Move(Double, Double)
    Move(Double, Double)
    Move(Double, Double)

    Moves the control.

    public void Move(Double x, Double y)public void Move(Double x, Double y)Public Function Move(x As Double, y As Double) As voidpublic void Move(Double x, Double y)

    Parameters

    • x
      System.Double
      System.Double
      System.Double

      The absolute screen coordinates of the left side of the control.

    • y
      System.Double
      System.Double
      System.Double

      The absolute screen coordinates of the top of the control.

  • Resize(Double, Double)
    Resize(Double, Double)
    Resize(Double, Double)
    Resize(Double, Double)

    Resizes the control.

    public void Resize(Double width, Double height)public void Resize(Double width, Double height)Public Function Resize(width As Double, height As Double) As voidpublic void Resize(Double width, Double height)

    Parameters

    • width
      System.Double
      System.Double
      System.Double

      The new width of the window, in pixels.

    • height
      System.Double
      System.Double
      System.Double

      The new height of the window, in pixels.

  • Rotate(Double)
    Rotate(Double)
    Rotate(Double)
    Rotate(Double)

    Rotates the control.

    public void Rotate(Double degrees)public void Rotate(Double degrees)Public Function Rotate(degrees As Double) As voidpublic void Rotate(Double degrees)

    Parameters

    • degrees
      System.Double
      System.Double
      System.Double

      The number of degrees to rotate the control. A positive number rotates the control clockwise. A negative number rotates the control counterclockwise.

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.GuidAttribute
Windows.Foundation.Metadata.WebHostHiddenAttribute

Details

Assembly

Windows.UI.Xaml.Automation.Provider.dll