Vzor ovládacího prvku TextChild
Představuje pokyny a konvence pro implementaci ITextChildProvider, včetně informací o vlastnostech a metodách. Vzor ovládacího prvku TextChild slouží k přístupu k nejbližšímu nadřazeného prvku, který podporuje vzor ovládacího prvku Text.
Předpokládejme například, že text v dokumentu obsahuje vložený obrázek a hypertextový odkaz, jak je znázorněno na následujícím obrázku.
Pokud použijete nástroje Microsoft UI Automation k prozkoumání stromu automatizace uživatelského rozhraní pro tento obsah dokumentu, může zobrazit prvek dokumentu s jedním podřízeným prvkem, který představuje obrázek, a další podřízený prvek, který představuje hypertextový odkaz. Například:
Element dokumentu v předchozím příkladu obvykle podporuje Text vzor ovládacího prvku, ale dva podřízené prvky prvku dokumentu ne. Pokud má klientská aplikace automatizace uživatelského rozhraní odkaz na prvek obrázku nebo element hypertextového odkazu, může klient použít TextChild řídicí vzor jako pohodlný způsob, jak získat přístup k vzoru Textcontrol vystavený obsahujícím elementem dokumentu.
Pokyny a konvence implementace
Při implementaci rozhraní ITextChildProvider si poznamenejte následující pokyny a konvence:
- Vlastnost ITextChildProvider::TextContainer by měla určit nejbližší nadřazený prvek, který podporuje ITextProvider rozhraní, bez ohledu na to, zda prvky vyšší v nadřazené řetězu také podporují ITextProvider.
- Prvek by neměl podporovatITextProvider i ITextChildProvider** rozhraní.
- Element, který implementuje ITextChildProvider musí být podřízený nebo sestupný prvek, který implementuje ITextProvider. Není nutné, aby tento prvek také implementovat Text vzor ovládacího prvku.
- ITextChildProvider::TextRange vlastnost by měla určit stejnou textovou oblast jako ten, který obsahující prvek zprostředkovatele textu vrátí, když jeho ITextProvider::RangeFromChild funkce je volána s textovým podřízeným elementem jako uzavřený podřízený prvek.
Požadované členy pro ITextChildProvider
Tyto vlastnosti a metody jsou vyžadovány pro implementaci ITextChildProvider rozhraní.
| Požadované členy | Typ členu | Poznámky |
|---|---|---|
| TextContainer | Vlastnost | Žádný |
| TextRange | Vlastnost | Žádný |
Tento vzor ovládacího prvku nemá žádné přidružené metody ani události.
Související témata
koncepční
- 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í