Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ITransformProvider.Move Method

Moves the control.

Namespace:  System.Windows.Automation.Provider
Assembly:  UIAutomationProvider (in UIAutomationProvider.dll)
void Move(
	double x,
	double y
)

Parameters

x
Type: System.Double

Absolute screen coordinates of the left side of the control.

y
Type: System.Double

Absolute screen coordinates of the top of the control.

ExceptionCondition
InvalidOperationException

If the CanMove property is false.

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 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. In these cases 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.

The following example shows one possible implementation of this method for a custom control that can be moved.

/// <summary> 
/// Moves the provider to the specified position. 
/// </summary> 
/// <param name="x">The specified X screen coordinate.</param>
/// <param name="y">The specified Y screen coordinate</param>
void ITransformProvider.Move(double x, double y)
{
    int leftInt = (int)x;
    int topInt = (int)y;

    if (!((ITransformProvider)this).CanMove)
        throw new InvalidOperationException(
            "Operation cannot be performed.");

    // Move should never be allowed to place a control outside the  
    // bounds of its container; the control should always be accessible  
    // using the keyboard or mouse. 
    // Use the bounds of the parent window to limit the placement  
    // of the custom control. 
    int maxLeft = 10;
    int maxTop = 10;
    int maxRight = 
        this.customControl.formWidth - this.customControl.Width - 10;
    int maxBottom = 
        this.customControl.formHeight - this.customControl.Height - 10;

    if (leftInt < maxLeft)
        leftInt = 0;
    if (topInt < maxTop)
        topInt = 0;
    if (leftInt > maxRight)
        leftInt = maxRight;
    if (topInt > maxBottom)
        topInt = maxBottom;

    // Invoke control method on separate thread to avoid clashing with UI. 
    // Use anonymous method for simplicity. 
    this.customControl.Invoke(new MethodInvoker(delegate()
    {
        this.customControl.Left = leftInt;
        this.customControl.Top = topInt;
    }));
}

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.