Wzorce kontrolek automatyzacji interfejsu użytkownika dla klientówUI Automation Control Patterns for Clients

Uwaga

Ta dokumentacja jest przeznaczona dla .NET Framework deweloperów, którzy chcą korzystać z zarządzanych klas Automatyzacja interfejsu użytkownikaUI Automation zdefiniowanych w przestrzeni nazw System.Windows.Automation.This documentation is intended for .NET Framework developers who want to use the managed Automatyzacja interfejsu użytkownikaUI Automation classes defined in the System.Windows.Automation namespace. Aby uzyskać najnowsze informacje na temat Automatyzacja interfejsu użytkownikaUI Automation, zobacz interfejs API usługi Windows Automation: Automatyzacja interfejsu użytkownika.For the latest information about Automatyzacja interfejsu użytkownikaUI Automation, see Windows Automation API: UI Automation.

W tym omówieniu przedstawiono wzorce kontroli dla klientów automatyzacji interfejsu użytkownika.This overview introduces control patterns for UI Automation clients. Zawiera informacje o tym, jak klient automatyzacji interfejsu użytkownika może używać wzorców kontroli w celu uzyskania dostępu do informacji o interfejs użytkownika (UI)user interface (UI).It includes information on how a UI Automation client can use control patterns to access information about the interfejs użytkownika (UI)user interface (UI).

Wzorce kontrolek umożliwiają kategoryzowanie i Uwidacznianie funkcjonalności formantu niezależnie od typu formantu lub wyglądu kontrolki.Control patterns provide a way to categorize and expose a control's functionality independent of the control type or the appearance of the control. Klienci automatyzacji interfejsu użytkownika mogą przeanalizować AutomationElement, aby określić, które wzorce kontroli są obsługiwane, i zapewnić zachowanie kontrolki.UI Automation clients can examine an AutomationElement to determine which control patterns are supported and be assured of the behavior of the control.

Aby uzyskać pełną listę wzorców kontrolek, zobacz Omówienie wzorców kontrolek automatyzacji interfejsu użytkownika.For a complete list of control patterns, see UI Automation Control Patterns Overview.

Pobieranie wzorców kontrolekGetting Control Patterns

Klienci pobierają wzorzec kontroli z AutomationElement, wywołując AutomationElement.GetCachedPattern lub AutomationElement.GetCurrentPattern.Clients retrieve a control pattern from an AutomationElement by calling either AutomationElement.GetCachedPattern or 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 są obsługiwane na AutomationElement.Clients can use the GetSupportedPatterns method or an individual IsPatternAvailable property (for example, IsTextPatternAvailableProperty) to determine if a pattern or group of patterns is supported on the AutomationElement. Jednak bardziej wydajną próbą jest uzyskanie wzorca kontroli i testu dla odwołania null niż w celu sprawdzenia obsługiwanych właściwości i pobrania wzorca kontrolki, ponieważ powoduje to zmniejszenie liczby wywołań między procesami.However, it is more efficient to attempt to get the control pattern and test for a null reference than to check the supported properties and retrieve the control pattern since it results in fewer cross-process calls.

Poniższy przykład ilustruje, jak uzyskać TextPattern wzorzec formantu z AutomationElement.The following example demonstrates how to get a TextPattern control pattern from an 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 dla wzorców formantówRetrieving Properties on Control Patterns

Klienci mogą pobierać wartości właściwości w wzorcach kontroli przez wywołanie AutomationElement.GetCachedPropertyValue lub AutomationElement.GetCurrentPropertyValue i rzutowanie obiektu zwróconego na odpowiedni typ.Clients can retrieve the property values on control patterns by calling either AutomationElement.GetCachedPropertyValue or AutomationElement.GetCurrentPropertyValue and casting the object returned to an appropriate type. Aby uzyskać więcej informacji na temat właściwości Automatyzacja interfejsu użytkownikaUI Automation, zobacz właściwości automatyzacji interfejsu użytkownika dla klientów.For more information on Automatyzacja interfejsu użytkownikaUI Automation properties, see UI Automation Properties for Clients.

Poza metodami GetPropertyValue wartości właściwości można pobrać za pomocą metod dostępu środowiska uruchomieniowego języka wspólnego (CLR), aby uzyskać dostęp do właściwości Automatyzacja interfejsu użytkownikaUI Automation wzorca.In addition to the GetPropertyValue methods, property values can be retrieved through the common language runtime (CLR) accessors to access the Automatyzacja interfejsu użytkownikaUI Automation properties on a pattern.

Kontrolki ze wzorcami zmiennychControls with Variable Patterns

Niektóre typy formantów obsługują różne wzorce w zależności od ich stanu lub sposobu, w jaki formant jest używany.Some control types support different patterns depending on their state or the manner in which the control is being used. Przykłady formantów, które mogą mieć wzorce zmiennych, to widoki listy (miniatury, kafelki, ikony, lista, szczegóły), wykresy programu Microsoft Excel (kołowy, liniowy, słupkowy, wartość komórki z formułą), obszar dokumentu programu Microsoft Word (normalny, układ sieci Web, konspekt, układ wydruku, drukowanie Wersja zapoznawcza) i karnacje programu Microsoft Windows Media Player.Examples of controls that can have variable patterns are list views (thumbnails, tiles, icons, list, details), Microsoft Excel Charts (Pie, Line, Bar, Cell Value with a formula), Microsoft Word's document area (Normal, Web Layout, Outline, Print Layout, Print Preview), and Microsoft Windows Media Player skins.

Kontrolki implementujące niestandardowe typy kontrolek mogą mieć dowolny zestaw wzorców kontroli, które są potrzebne do reprezentowania ich funkcjonalności.Controls implementing custom control types can have any set of control patterns that are needed to represent their functionality.

Zobacz takżeSee also