Aracılığıyla paylaş

Desteklenen UI Otomasyon Denetim Düzenlerini Alma

  • Makale

Not

Bu belgeler, ad alanında tanımlanan yönetilen UI Otomasyonu sınıflarını kullanmak isteyen .NET Framework geliştiricilerine System.Windows.Automation yöneliktir. UI Otomasyonu hakkında en son bilgiler için bkz. Windows Otomasyonu API'si: UI Otomasyonu.

Bu konuda, UI Otomasyonu öğelerden denetim deseni nesnelerinin nasıl alınacakları gösterilmektedir.

Tüm Denetim Desenlerini Alma

  1. AutomationElement İlgilendiğiniz denetim desenlerini alın.

  2. öğesinden tüm denetim desenlerini almak için çağrısı GetSupportedPatterns yapın.

Dikkat

bir istemcinin kullanmaması GetSupportedPatternskesinlikle önerilir. Bu yöntem mevcut her denetim deseni için dahili olarak çağırdıkça GetCurrentPattern performans ciddi şekilde etkilenebilir. Mümkünse, bir istemcinin ilgi çekici anahtar desenlerini çağırması GetCurrentPattern gerekir.

Belirli bir Denetim Deseni Alma

  1. AutomationElement İlgilendiğiniz denetim desenlerini alın.

  2. Belirli bir deseni sorgulamak için veya TryGetCurrentPattern çağrısıGetCurrentPattern. Bu yöntemler benzerdir, ancak desen bulunamazsa GetCurrentPattern bir özel durum oluşturur ve TryGetCurrentPattern döndürür false.

Örnek

Aşağıdaki örnek, liste öğesi için bir AutomationElement alır ve bu öğeden bir SelectionItemPattern alır.

/// <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();
    }
}

''' <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 Sub SelectListItem(ByVal listElement As AutomationElement, ByVal itemText As String)
    If listElement Is Nothing OrElse itemText = "" Then
        Throw New ArgumentException("Argument cannot be null or empty.")
    End If
    listElement.SetFocus()
    Dim cond As New PropertyCondition(AutomationElement.NameProperty, itemText, PropertyConditionFlags.IgnoreCase)
    Dim elementItem As AutomationElement = listElement.FindFirst(TreeScope.Children, cond)
    If Not (elementItem Is Nothing) Then
        Dim pattern As SelectionItemPattern
        Try
            pattern = DirectCast(elementItem.GetCurrentPattern(SelectionItemPattern.Pattern), _
                SelectionItemPattern)
        Catch ex As InvalidOperationException
            Console.WriteLine(ex.Message) ' Most likely "Pattern not supported."
            Return
        End Try
        pattern.Select()
    End If

End Sub

Ayrıca bkz.