MultipleViewPattern.SetCurrentView(Int32) Metoda

Reference

Definice

Obor názvů:: System.Windows.Automation

Sestavení:: UIAutomationClient.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Nastaví aktuální zobrazení specifické pro ovládací prvek.

public:
 void SetCurrentView(int viewId);

public void SetCurrentView (int viewId);

member this.SetCurrentView : int -> unit

Public Sub SetCurrentView (viewId As Integer)

Parametry

viewId: Int32

Identifikátor zobrazení specifický pro ovládací prvek.

Výjimky

ArgumentException

viewId není členem podporované kolekce zobrazení.

Příklady

V následujícím příkladu se načte kolekce zobrazení dostupných pro ovládací prvek, který podporuje MultipleViewPattern vzor ovládacího prvku. Člen kolekce identifikátorů zobrazení se následně použije k úpravě aktuálního zobrazení ovládacího prvku.

///--------------------------------------------------------------------
/// <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

Poznámky

Identifikátory zobrazení lze načíst pomocí GetSupportedViews.

Kolekce identifikátorů zobrazení specifická pro ovládací prvky je identická napříč instancemi.

Platí pro

Sdílet prostřednictvím