MultipleViewPattern.SetCurrentView(Int32) Méthode

Définition

Espace de noms:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Définit l’affichage actuel spécifique au contrôle.

public:
 void SetCurrentView(int viewId);

public void SetCurrentView (int viewId);

member this.SetCurrentView : int -> unit

Public Sub SetCurrentView (viewId As Integer)

Paramètres

viewId

Int32

Identificateur de l’affichage spécifique au contrôle.

Exceptions

ArgumentException

viewId n’est pas un membre de la collection d’affichages prise en charge.

Exemples

Dans l’exemple suivant, la collection de vues disponibles pour un contrôle qui prend en charge le modèle de MultipleViewPattern contrôle est récupérée. Un membre de la collection d’identificateurs d’affichage est ensuite utilisé pour modifier l’affichage actuel du contrôle.

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

Remarques

Les identificateurs d’affichage peuvent être récupérés à l’aide GetSupportedViewsde .

La collection spécifique au contrôle d’identificateurs d’affichage est identique entre les instances.