ITransformProvider.Resize(Double, Double) Methode

Referenz

Definition

Namespace:: System.Windows.Automation.Provider

Assembly:: UIAutomationProvider.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ändert die Größe des Steuerelements.

public:
 void Resize(double width, double height);

public void Resize (double width, double height);

abstract member Resize : double * double -> unit

Public Sub Resize (width As Double, height As Double)

Parameter

width: Double

Die neue Breite des Fensters in Pixeln.

height: Double

Die neue Höhe des Fensters in Pixeln.

Ausnahmen

InvalidOperationException

Wenn die CanResize-Eigenschaft „false“ ist.

Beispiele

Das folgende Beispiel zeigt eine mögliche Implementierung dieser Methode für ein benutzerdefiniertes Steuerelement, das die Größe ändern kann.

/// <summary>
/// Resizes the provider to the specified height and width.
/// </summary>
/// <param name="height">The specified height.</param>
/// <param name="width">The specified width.</param>
void ITransformProvider.Resize(double width, double height)
{
    if (!((ITransformProvider)this).CanResize)
        throw new InvalidOperationException("Operation cannot be performed.");

    if (width <= 0 | height <= 0)
        throw new InvalidOperationException("Operation cannot be performed.");

    int widthInt = (int)width;
    int heightInt = (int)height;

    // Resize 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.
    Size MaxSize =
        new Size(this.customControl.formWidth - 20,
        this.customControl.formHeight - 20);
    Size MinSize = new Size(10, 10);

    if (widthInt > MaxSize.Width)
        widthInt = MaxSize.Width;
    if (heightInt > MaxSize.Height)
        heightInt = MaxSize.Height;
    if (widthInt < MinSize.Width)
        widthInt = MinSize.Width;
    if (heightInt < MinSize.Height)
        heightInt = MinSize.Height;

    // Invoke control method on separate thread to avoid clashing with UI.
    // Use anonymous method for simplicity.
    this.customControl.Invoke(new MethodInvoker(delegate ()
    {
        this.customControl.Size = new Size(widthInt, heightInt);
    }));
}

''' <summary>
''' Resizes the provider to the specified height and width.
''' </summary>
''' <param name="height">The specified height.</param>
''' <param name="width">The specified width.</param>
Private Sub Resize(ByVal width As Double, ByVal height As Double) Implements ITransformProvider.Resize
    If Not(CType(Me, ITransformProvider)).CanResize Then
        Throw New InvalidOperationException("Operation cannot be performed.")
    End If

    If width <= 0 Or height <= 0 Then
        Throw New InvalidOperationException("Operation cannot be performed.")
    End If

    Dim widthInt As Integer = CInt(width)
    Dim heightInt As Integer = CInt(height)

    ' Resize 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.
    Dim MaxSize As New Size(Me.customControl.formWidth - 20, Me.customControl.formHeight - 20)
    Dim MinSize As New Size(10, 10)

    If widthInt > MaxSize.Width Then
        widthInt = MaxSize.Width
    End If
    If heightInt > MaxSize.Height Then
        heightInt = MaxSize.Height
    End If
    If widthInt < MinSize.Width Then
        widthInt = MinSize.Width
    End If
    If heightInt < MinSize.Height Then
        heightInt = MinSize.Height
    End If

    ' Invoke control method on separate thread to avoid clashing with UI.
    ' Use anonymous method for simplicity.
    Me.customControl.Invoke(New MethodInvoker(Sub() Me.customControl.Size = New Size(widthInt, heightInt)))
End Sub

Hinweise

Wenn diese Methode für ein Steuerelement aufgerufen wird, das geteilte Bereiche unterstützt, kann diese Methode die Größe anderer zusammenhängender Bereiche ändern.

Ein Objekt kann nicht verschoben, in der Größe geändert oder gedreht werden, sodass die resultierende Bildschirmposition vollständig außerhalb der Koordinaten des Containers und für Tastatur oder Maus nicht zugänglich wäre. Beispielsweise, wenn ein Fenster der obersten Ebene vollständig aus dem Bildschirm verschoben wird oder ein untergeordnetes Objekt außerhalb der Grenzen des Viewports des Containers verschoben wird. In diesen Fällen wird das Objekt so nah wie möglich an den angeforderten Bildschirmkoordinaten platziert, wobei die oberen oder linken Koordinaten überschrieben werden, um sich innerhalb der Containergrenzen zu befinden.

Gilt für:

Weitere Informationen

Implementieren des Transform-Steuerelementmusters der Benutzeroberflächenautomatisierung