Udostępnij za pośrednictwem

Wzorce kontrolne automatyzacji interfejsu użytkownika dla użytkowników

Uwaga / Notatka

Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacji interfejsu użytkownika zdefiniowanych w przestrzeni nazw System.Windows.Automation. Aby uzyskać najnowsze informacje na temat automatyzacji interfejsu użytkownika, zobacz Windows Automation API: Automatyzacja interfejsu użytkownika.

W tym omówieniu przedstawiono wzorce sterowania dla klientów automatyzacji interfejsu użytkownika. Zawiera on informacje na temat sposobu, w jaki klient automatyzacji interfejsu użytkownika może używać wzorców kontroli w celu uzyskania dostępu do informacji o interfejsie użytkownika.

Wzorce kontrolek umożliwiają kategoryzowanie i uwidacznianie funkcjonalności kontrolki niezależnie od typu kontrolki lub wyglądu kontrolki. Klienci automatyzacji interfejsu użytkownika mogą sprawdzać AutomationElement, aby określić, które wzorce sterowania są obsługiwane, i mieć pewność co do działania elementu sterującego.

Aby uzyskać pełną listę wzorców kontrolek, zobacz Omówienie wzorców kontrolek automatyzacji interfejsu użytkownika.

Pobieranie wzorców kontrolek

Klienci pobierają wzorzec kontrolki z obiektu AutomationElement przez wywołanie metody AutomationElement.GetCachedPattern lub AutomationElement.GetCurrentPattern.

Klienci mogą używać metody GetSupportedPatterns lub pojedynczej właściwości IsPatternAvailable (na przykład IsTextPatternAvailableProperty), aby określić, czy wzorzec lub grupa wzorców jest obsługiwana na AutomationElement. Jednak bardziej wydajne jest podjęcie próby uzyskania wzorca kontrolki i przetestowania null odwołania niż sprawdzenie obsługiwanych właściwości i pobranie wzorca kontrolki, ponieważ powoduje to mniej wywołań między procesami.

W poniższym przykładzie pokazano, jak uzyskać TextPattern wzorzec kontrolki z elementu AutomationElement.

// Specify the control type we're looking for, in this case 'Document'
PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

// target --> The root AutomationElement.
AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

targetTextPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

if (targetTextPattern == null)
{
    Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
    return;
}

Pobieranie właściwości we wzorcach kontrolek

Klienci mogą pobierać wartości właściwości we wzorcach kontrolek, wywołując AutomationElement.GetCachedPropertyValue lub AutomationElement.GetCurrentPropertyValue i rzutując obiekt zwrócony na odpowiedni typ. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Właściwości automatyzacji interfejsu użytkownika dla klientów.

Oprócz metod GetPropertyValue, wartości właściwości mogą być pobierane za pomocą akcesorów środowiska uruchomieniowego języka wspólnego (CLR) w celu uzyskania dostępu do właściwości automatyzacji interfejsu użytkownika w ramach wzorca.

Kontrolki ze wzorcami zmiennych

Niektóre typy kontrolek obsługują różne wzorce w zależności od ich stanu lub sposobu, w jaki jest używana kontrolka. Przykłady elementów sterujących, które mogą mieć zmienne wzorce, to widoki list (miniatury, kafelki, ikony, lista, szczegóły), wykresy w Microsoft Excel (kołowe, liniowe, słupkowe, wartości komórek z formułą), obszar dokumentu w Microsoft Word (normalny, układ sieciowy, konspekt, układ wydruku, podgląd wydruku) i skórki Microsoft Windows Media Player.

Kontrolki implementujące niestandardowe typy kontrolek mogą mieć dowolny zestaw wzorców sterujących, które są potrzebne do reprezentowania ich funkcjonalności.

Zobacz także