Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

AutomationElement.GetCurrentPattern méthode (AutomationPattern)

 

Date de publication : novembre 2016

Récupère l'objet de modèle spécifié sur ce AutomationElement.

Espace de noms:   System.Windows.Automation
Assembly:  UIAutomationClient (dans UIAutomationClient.dll)

public object GetCurrentPattern(
	AutomationPattern pattern
)

Paramètres

pattern
Type: System.Windows.Automation.AutomationPattern

Identificateur du modèle à récupérer.

Valeur de retour

Type: System.Object

Objet de modèle, si le modèle spécifié est actuellement pris en charge par AutomationElement.

Exception Condition
InvalidOperationException

Le modèle n’est pas pris en charge par l’élément.

ElementNotAvailableException

L’interface utilisateur pour AutomationElement n’existe plus.

GetCurrentPattern Obtient le modèle spécifié en fonction de sa disponibilité au moment de l’appel.

Pour certaines formes de Interface utilisateur, cette méthode entraîne une baisse des performances interprocessus. Les applications peuvent concentrer la charge par la mise en cache des modèles et puis de les récupérer à l’aide de GetCachedPattern.

L’exemple suivant montre comment utiliser cette méthode pour récupérer un SelectionItemPattern, qui est ensuite utilisé pour sélectionner un élément dans une zone de liste.

/// <summary>
/// Sets the focus to a list and selects a string item in that list.
/// </summary>
/// <param name="listElement">The list element.</param>
/// <param name="itemText">The text to select.</param>
/// <remarks>
/// This deselects any currently selected items. To add the item to the current selection 
/// in a multiselect list, use AddToSelection instead of Select.
/// </remarks>
public void SelectListItem(AutomationElement listElement, String itemText)
{
    if ((listElement == null) || (itemText == ""))
    {
        throw new ArgumentException("Argument cannot be null or empty.");
    }
    listElement.SetFocus();
    Condition cond = new PropertyCondition(
        AutomationElement.NameProperty, itemText, PropertyConditionFlags.IgnoreCase);
    AutomationElement elementItem = listElement.FindFirst(TreeScope.Children, cond);
    if (elementItem != null)
    {
        SelectionItemPattern pattern;
        try
        {
            pattern = elementItem.GetCurrentPattern(SelectionItemPattern.Pattern) as SelectionItemPattern;
        }
        catch (InvalidOperationException ex)
        {
            Console.WriteLine(ex.Message);  // Most likely "Pattern not supported."
            return;
        }
        pattern.Select();
    }
}
System_CAPS_noteRemarque

Pour les tâches très répétitives telles que celle de l’exemple, il serait plus efficace de mettre en cache le modèle et utiliser GetCachedPattern.

.NET Framework
Disponible depuis 3.0
Retour au début
Afficher: