Typ ovládacího prvku Číselník
Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku Spinner.
Ovládací prvky číselníku se používají k výběru z domény položek nebo rozsahu čísel.
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 Spin ner. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky číselníku, ve 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ýkají ovládacích prvků číselníku, když podporují RangeValue a Výběr vzory ovládacích prvků 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í.
vzor ovládacího prvku RangeValue
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
|
|
vzor ovládacího prvku výběru
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
|
|
Chcete-li zajistit, aby byla dvě tlačítka v podstromu zobrazení ovládacího prvku rozlišena automatizovanými testovacími nástroji, přiřaďte ScrollAmount_SmallIncrement nebo ScrollAmount_SmallDecrement hodnotu vlastnosti AutomationId podle potřeby. U některých implementací může být přidružený ovládací prvek pro úpravy partnerským vztahem číselníku.
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 číselníku. 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. | Ovládacího prvku číselník, na který lze kliknout, se fokus zaměřuje na část ovládacího prvku pro úpravy. |
| UIA_ControlTypePropertyId | číselníku | Tato hodnota je stejná pro všechny architektury. |
| UIA_IsContentElementPropertyId | PRAVDIVÝ | Ovládací prvek číselníku musí být vždy obsah. |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Ovládací prvek číselníku musí být vždy ovládací prvek. |
| UIA_IsKeyboardFocusablePropertyId | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. Ovládací prvek číselníku zřídka vezme fokus, ale pokud ano, fokus by měl zůstat na samotném ovládacím prvku číselníku, ne na podřízených tlačítkách. Uživatel by měl být schopen provádět všechny akce posouvání pomocí kláves ŠIPKA NAHORU a ŠIPKA DOLŮ. |
| UIA_LabeledByPropertyId | Viz poznámky. | Ovládací prvky číselníku mají statický textový popisek. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku Spinner. Výchozí hodnota je číselník pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Viz poznámky. | Ovládací prvek číselníku obvykle získá jeho název ze statického textového popisku. |
Požadované vzory ovládacích prvků
Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které musí podporovat všechny ovládací prvky číselníku. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vlastnost vzoru ovládacího prvku nebo vzoru | Podpora/hodnota | Poznámky |
|---|---|---|
| IRangeValueProvider | Závisí | Ovládací prvky číselníku, které pokrývají číselný rozsah, můžou podporovat RangeValue vzor ovládacího prvku. |
| ISelectionProvider | Závisí | Ovládací prvky číselníku, které mají být vybrány, musí podporovat ovládací prvek Výběr. |
| CanSelectMultiple | FALEŠNÝ | Ovládací prvky číselníku jsou vždy kontejnery s jedním výběrem. |
| IValueProvider | Závisí | Ovládací prvky číselníku, které zahrnují descrete sadu možností nebo čísel, můžou podporovat hodnotu vzor ovládacího prvku. |
Požadované události
V následující tabulce jsou uvedeny události automatizace uživatelského rozhraní, které jsou pro podporu ovládacích prvků spinneru potřeba. 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_RangeValueValuePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje RangeValue vzor ovládacího prvku, musí tuto událost podporovat. |
| UIA_Selection_InvalidatedEventId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacího prvku Výběr, musí tuto událost podporovat. |
| UIA_StructureChangedEventId | |
| UIA_ValueValuePropertyId událost změny vlastnosti. | Pokud ovládací prvek podporuje vzor ovládacího prvku Hodnota, musí tuto událost podporovat. |
Související témata