AutomationElement.GetCurrentPattern(AutomationPattern) Yöntem

Tanım

Ad Alanı:

System.Windows.Automation

Bütünleştirilmiş Kod:

UIAutomationClient.dll

Bu AutomationElementüzerinde belirtilen desen nesnesini alır.

public:
 System::Object ^ GetCurrentPattern(System::Windows::Automation::AutomationPattern ^ pattern);

public object GetCurrentPattern (System.Windows.Automation.AutomationPattern pattern);

member this.GetCurrentPattern : System.Windows.Automation.AutomationPattern -> obj

Public Function GetCurrentPattern (pattern As AutomationPattern) As Object

Parametreler

pattern

AutomationPattern

Alınacak desenin tanımlayıcısı.

Döndürülenler

Object

Belirtilen desen tarafından şu anda destekleniyorsa AutomationElementdesen nesnesi.

Özel durumlar

InvalidOperationException

Desen öğesi tarafından desteklenmiyor.

ElementNotAvailableException

için AutomationElement kullanıcı arabirimi artık yok.

Örnekler

Aşağıdaki örnekte, bu yöntemin bir öğesini almak SelectionItemPatterniçin nasıl kullanılacağı gösterilmektedir. Bu yöntem daha sonra liste kutusunda bir öğe seçmek için kullanılı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

Not

Örnekteki gibi sık tekrarlanan görevler için deseni önbelleğe almak ve kullanmak GetCachedPatterndaha verimli olacaktır.

Açıklamalar

GetCurrentPattern , çağrı sırasında kullanılabilirliğine göre belirtilen deseni alır.

Bazı kullanıcı arabirimi biçimleri için bu yöntem işlemler arası performans ek yüküne neden olur. Uygulamalar, desenleri önbelleğe alıp kullanarak GetCachedPatternbunları alarak ek yükü yoğunlaştırabilir.

Ayrıca bkz.

• İstemciler İçin UI Otomasyon Denetim Düzenleri