Typ ovládacího prvku palec
Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku Thumb.
Ovládací prvky palec poskytují funkce, které umožňují přesunutí ovládacího prvku (nebo přetažení), jako je například tlačítko posuvníku nebo změna velikosti, například widget pro změnu velikosti okna. Všimněte si, že ovládací prvek palce neposkytuje funkce přetažení. Ovládání palcem může přijímat fokus myši, ale ne fokus klávesnice. Vývojář ovládacího prvku musí ovládací prvek implementovat, aby správně funguje (lze ho přetáhnout nebo změnit jeho velikost).
Následující části definují požadovanou strukturu stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Thumb. Požadavky na automatizaci uživatelského rozhraní používají všechny ovládací prvky, u kterých architektura uživatelského rozhraní nebo platforma integruje podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.
Toto téma obsahuje následující části.
- typické stromové struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- požadovaných událostí
- související témata
Typická stromová struktura
Následující tabulka znázorňuje typické zobrazení ovládacího prvku a obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků palce a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní naleznete v tématu přehled stromu automatizace uživatelského rozhraní.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
|
(Nepoužitelné) |
Ovládací prvky palec se v zobrazení obsahu nikdy nezobrazují, protože existují jen pro manipulaci s myší. Jsou vystaveny i přes jiný vzor ovládacích prvků, jako je například vzor ovládacích prvků Scroll, Transformace vzor ovládacího prvku nebo RangeValue vzor ovládacího prvku, který je podporován v kontejneru ovládacího prvku kryptografie.
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky palce. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.
| Vlastnost automatizace uživatelského rozhraní | Hodnota | Poznámky |
|---|---|---|
| UIA_AutomationIdPropertyId | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní. |
| UIA_BoundingRectanglePropertyId | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| UIA_ClickablePointPropertyId | Viz poznámky. | Bod v viditelné klientské oblasti ovládacího prvku palce. |
| UIA_ControlTypePropertyId | palec | |
| UIA_IsContentElementPropertyId | FALEŠNÝ | Ovládací prvek palec nikdy není součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní. |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Ovládací prvek palce je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní. |
| UIA_IsKeyboardFocusablePropertyId | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. Ovládací prvek palce může získat fokus, pokud se používá jako objekt úchytu pro změnu velikosti okna nebo podokna. Ovládací prvek palce na posuvníku nebo posuvníku by nikdy neměl dostat fokus. |
| UIA_LabeledByPropertyId | NULA | Ovládací prvky palec nikdy nemají popisek. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku Thumb. Výchozí hodnota je "thumb" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | NULA | Vzhledem k tomu, že ovládací prvek palec není k dispozici v zobrazení obsahu stromu Automatizace uživatelského rozhraní, nevyžaduje název. |
Požadované vzory ovládacích prvků
V následující tabulce jsou uvedeny vzory ovládacích prvků automatizace uživatelského rozhraní, které musí být podporovány ovládacími prvky palce. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vzor ovládacího prvku | Podpora | Poznámky |
|---|---|---|
| ITransformProvider | Požadovaný | Povolí přesunutí ovládacího prvku palce na obrazovce. Vzhledem k tomu, že ovládací prvek palce obvykle nelze změnit nebo otočit, Transformace vzor ovládacích prvků primárně podporuje funkci Move. |
Požadované události
Následující tabulka uvádí události automatizace uživatelského rozhraní, které jsou nezbytné pro podporu ovládacích prvků palce. Další informace o událostech najdete v tématu Přehled událostí automatizace uživatelského rozhraní.
| Událost automatizace uživatelského rozhraní | Poznámky |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId událost změněnou vlastností. | |
| UIA_IsEnabledPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat. |
| UIA_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| UIA_StructureChangedEventId |
Související témata