Wzorzec kontrolki Style

Opisuje wytyczne i konwencje implementowania IStylesProvider, w tym informacje o właściwościach i metodach. Wzorzec kontrolki style służy do opisywania elementu interfejsu użytkownika, który ma określony styl, kolor wypełnienia, deseń wypełnienia lub kształt.

Wzorzec kontrolek style jest szczególnie przydatny do opisywania elementów w dokumencie, które często mają takie style. Style zwykle zawierają informacje przydatne dla klientów niepełnosprawnych; na przykład styl może opisywać określony ciąg jako tytuł dokumentu lub określony obiekt schematu blokowego jako romb lub okrąg. Aby zapoznać się z przykładami kontrolek implementujących ten wzorzec kontrolki, zobacz typy kontrolek i obsługiwane wzorce kontrolek.

Ten temat zawiera następujące sekcje.

• wytyczne i konwencje implementacji
• wymagane elementy członkowskie IStylesProvider
• Tematy pokrewne

Wytyczne i konwencje implementacji

Podczas implementowania wzorca kontrolek Styles należy pamiętać o następujących wytycznych i konwencjach:

• Plik nagłówka UIAutomationClient.h definiuje zestaw nazwanych wartości stałych używany do identyfikowania kilku typowych stylów. Aby uzyskać więcej informacji, zobacz Identyfikatory stylów.
• Jeśli używasz StyleId_Custom, musisz zaimplementować właściwość IStylesProvider::StyleName, aby umożliwić klientom odnajdywanie nazwy stylu. Nie trzeba implementować właściwości StyleName dla stylu standardowego, ponieważ usługa Microsoft UI Automation udostępnia nazwę domyślną, ale można ją zaimplementować, jeśli musisz zastąpić nazwę domyślną.
• Inne właściwości we wzorcu Styles są opcjonalne; dostawca może zwrócić UIA_E_NOTSUPPORTED dla właściwości, która nie jest obsługiwana.
• Style w zakresie tekstu mogą być reprezentowane za pomocą następujących atrybutów tekstowych:
  • W odpowiedzi na żądanie atrybutu tekstowego StyleId zakres tekstu powinien zwrócić jeden z identyfikatorów stylów opisanych w identyfikatorów stylów.
  • Jeśli StyleId_Custom jest używana, zakres tekstu powinien zwracać wartość ciągu dla atrybutu tekstowego StyleName, aby umożliwić klientom odnajdywanie nazwy stylu.
  • Zakres tekstu, który ma wiele stylów, takich jak nagłówek i zwykły tekst, powinien zwrócić specjalne właściwości automatyzacji interfejsu użytkownika ReservedMixedAttributeValue dla właściwości StyleId i StyleName. Klient odbierający tę odpowiedź może rozdzielić zakres tekstu, aby znaleźć, gdzie zaczynają się i kończą style.
• Aplikacje mogą używać szerokiej gamy stylów do opisywania obiektów, ale automatyzacja interfejsu użytkownika reprezentuje tylko najbardziej typowe. Aby reprezentować dodatkowe atrybuty stylu, takie jak kolor obramowania, dostawca może zwrócić listę dodatkowych atrybutów w właściwości ExtendedProperties. Jest to w zasadzie torba właściwości z zestawem właściwości rozszerzonych, takich jak "BorderColor=0xFF0000; BorderStyle=kropkowane". Wartości właściwości rozszerzonych mogą być specyficzne dla aplikacji.

Wymagane elementy członkowskie IStylesProvider

Następujące właściwości są wymagane do zaimplementowania interfejsu IStylesProvider.

Ten wzorzec kontrolki nie ma skojarzonych metod ani zdarzeń.

Tematy pokrewne

typów kontrolek i ich obsługiwanych wzorców kontrolek

Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie

Omówienie drzewa automatyzacji interfejsu użytkownika