Styly – vzor ovládacího prvku

Popisuje pokyny a konvence pro implementaci IStylesProvider, včetně informací o vlastnostech a metodách. Vzor ovládacího prvku Styly slouží k popisu prvku uživatelského rozhraní, který má určitý styl, barvu výplně, vzor výplně nebo obrazec.

Vzor ovládacích prvků Styly je zvlášť užitečný pro popis prvků v dokumentu, které tyto styly často obsahují. Styly obvykle obsahují informace, které jsou užitečné pro zákazníky s postižením; Například styl může popisovat určitý řetězec jako název dokumentu nebo určitý objekt vývojového diagramu jako kosočtverec nebo kruh. Příklady ovládacích prvků, které tento vzor ovládacích prvků implementují, najdete v tématu typy ovládacích prvků a jejich podporované vzory ovládacích prvků.

Toto téma obsahuje následující části.

• pokyny k implementaci a konvence
• požadované členy pro IStylesProvider
• související témata

Pokyny a konvence implementace

Při implementaci vzoru ovládacích prvků Styly si všimněte následujících pokynů a konvencí:

• Soubor hlavičky UIAutomationClient.h definuje sadu pojmenovaných konstantních hodnot sloužících k identifikaci několika běžných stylů. Další informace naleznete v tématu identifikátory stylů.
• Pokud používáte StyleId_Custom, musíte implementovat IStylesProvider::StyleName vlastnost povolit klientům zjistit název stylu. Není nutné implementovat vlastnost StyleName standardního stylu, protože Microsoft UI Automation poskytuje výchozí název, ale můžete ho implementovat, pokud potřebujete přepsat výchozí název.
• Ostatní vlastnosti v modelu Styly jsou volitelné; poskytovatel může vrátit UIA_E_NOTSUPPORTED pro vlastnost, která není podporována.
• Styly v oblasti textu lze reprezentovat pomocí následujících textových atributů:
  • Při odpovídání na požadavek na atribut StyleId text by rozsah textu měl vrátit jeden z identifikátorů stylu popsaných v identifikátory stylů.
  • Pokud se používá StyleId_Custom, měla by textová oblast vrátit hodnotu řetězce pro atribut StyleName text, aby klienti mohli zjistit název stylu.
  • Oblast textu, která má více stylů, například nadpis i normální text, by měla vrátit speciální vlastnost Automation uživatelského rozhraní ReservedMixedAttributeValue vlastnosti StyleId i StyleName vlastnosti. Klient, který obdrží tuto odpověď, může rozdělit rozsah textu, aby zjistil, kde styly začínají a končí.
• Aplikace můžou k popisu objektů používat širokou škálu stylů, ale automatizace uživatelského rozhraní představuje pouze ty nejběžnější. Chcete-li reprezentovat další atributy stylu, jako je barva ohraničení, může zprostředkovatel vrátit seznam dalších atributů v ExtendedProperties vlastnost. Jedná se v podstatě o tašku vlastností se sadou rozšířených vlastností, například BorderColor=0xFF0000; BorderStyle=tečkovaná". Hodnoty rozšířených vlastností můžou být specifické pro aplikaci.

Požadované členy pro IStylesProvider

Pro implementaci rozhraní IStylesProvider jsou vyžadovány následující vlastnosti.

Tento vzor ovládacího prvku nemá žádné přidružené metody ani události.

Související témata

typy ovládacích prvků a jejich podporované vzory ovládacích prvků

Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní

Přehled stromu automatizace uživatelského rozhraní