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 şu anda tarafından AutomationElementdestekleniyorsa desen nesnesi.

Özel durumlar

InvalidOperationException

Desen öğesi tarafından desteklenmiyor.

ElementNotAvailableException

kullanıcı AutomationElement arabirimi artık yok.

Örnekler

Aşağıdaki örnekte, bu yöntemi SelectionItemPatternkullanarak bir alma işleminin nasıl kullanılacağı gösterilmektedir. Bu yöntem, 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

Note

Ö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 yüküne neden olur. Uygulamalar, desenleri önbelleğe alıp kullanarak GetCachedPatternyüklerini yoğunlaştırabilir.

Ayrıca bkz.

• İstemciler İçin UI Otomasyonu Denetim Kalıpları