Bagikan melalui

Mendapatkan Pola Kontrol UI Automation yang Didukung

Catatan

Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas UI Automation terkelola yang ditentukan pada namespace System.Windows.Automation. Untuk informasi terbaru tentang UI Automation, lihat API Automasi Windows: Automasi Antarmuka Pengguna.

Topik ini menjelaskan cara mengambil objek pola kontrol dari elemen Automation UI.

Mendapatkan Semua Pola Kontrol

  1. Dapatkan AutomationElement yang pola kontrolnya Anda minati.

  2. Panggil GetSupportedPatterns untuk mendapatkan semua pola kontrol dari elemen.

Perhatian

Sangat disarankan agar klien tidak menggunakan GetSupportedPatterns. Performa dapat sangat terpengaruh karena metode ini memanggil GetCurrentPattern secara internal untuk setiap pola kontrol yang ada. Jika memungkinkan, klien harus memanggil GetCurrentPattern untuk pola kunci yang diminati.

Mendapatkan Pola Kontrol Tertentu

  1. Dapatkan AutomationElement yang pola kontrolnya Anda minati.

  2. Panggil GetCurrentPattern atau TryGetCurrentPattern untuk mengkueri pola tertentu. Metode ini serupa, tetapi jika pola tidak ditemukan, GetCurrentPattern memunculkan pengecualian, dan TryGetCurrentPattern menampilkan false.

Contoh

Contoh berikut mengambil AutomationElement untuk item daftar dan mendapatkan SelectionItemPattern dari elemen tersebut.

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

Lihat juga

  • Last updated on