MultipleViewPattern.SetCurrentView(Int32) Methode

Definition

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Legt die aktuelle steuerelementspezifische Ansicht fest.

public:
 void SetCurrentView(int viewId);

public void SetCurrentView (int viewId);

member this.SetCurrentView : int -> unit

Public Sub SetCurrentView (viewId As Integer)

Parameter

viewId

Int32

Ein steuerelementspezifischer Ansichtsbezeichner

Ausnahmen

ArgumentException

viewId ist kein Member der unterstützten Ansichtsauflistung.

Beispiele

Im folgenden Beispiel wird die Auflistung der Ansichten abgerufen, die für ein Steuerelement verfügbar sind, das das MultipleViewPattern Steuerelementmuster unterstützt. Anschließend wird ein Member der Ansichtsbezeichnerauflistung verwendet, um die aktuelle Ansicht des Steuerelements zu ändern.

///--------------------------------------------------------------------
/// <summary>
/// Sets the current view of a target.
/// </summary>
/// <param name="multipleViewControl">
/// The current multiple view control.
/// </param>
/// <param name="viewID">
/// The view identifier from the supported views collection.
/// </param>
///--------------------------------------------------------------------
private void SetView(AutomationElement multipleViewControl, int viewID)
{
    if (multipleViewControl == null)
    {
        throw new ArgumentNullException(
            "AutomationElement parameter must not be null.");
    }

    // Get a MultipleViewPattern from the current control.
    MultipleViewPattern multipleViewPattern = 
        GetMultipleViewPattern(multipleViewControl);

    if (multipleViewPattern != null)
    {
        try
        {
            multipleViewPattern.SetCurrentView(viewID);
        }
        // viewID is not a member of the supported views collection
        catch (ArgumentException)
        {
            // TO DO: error handling
        }
    }
}

'/--------------------------------------------------------------------
'/ <summary>
'/ Sets the current view of a target.
'/ </summary>
'/ <param name="multipleViewControl">
'/ The current multiple view control.
'/ </param>
'/ <param name="viewID">
'/ The view identifier from the supported views collection.
'/ </param>
'/--------------------------------------------------------------------
Private Sub SetView( _
ByVal multipleViewControl As AutomationElement, _
ByVal viewID As Integer)
    If multipleViewControl Is Nothing Then
        Throw New ArgumentNullException( _
        "AutomationElement parameter must not be null.")
    End If

    ' Get a MultipleViewPattern from the current control.
    Dim multipleViewPattern As MultipleViewPattern = _
    GetMultipleViewPattern(multipleViewControl)

    If Not (multipleViewPattern Is Nothing) Then
        Try
            multipleViewPattern.SetCurrentView(viewID)
        Catch exc As ArgumentException
            ' viewID is not a member of the supported views collection
            ' TO DO: error handling
        End Try
    End If
End Sub

Hinweise

Ansichtsbezeichner können mithilfe GetSupportedViewsvon abgerufen werden.

Die steuerelementspezifische Auflistung von Ansichtsbezeichnern ist instanzübergreifend identisch.