Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku okno
Poznámka:
Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy model UI Automation definované v System.Windows.Automation oboru názvů. Nejnovější informace o model UI Automation najdete v tématu Rozhraní API služby Windows Automation: model UI Automation.
Toto téma obsahuje informace o podpoře model UI Automation pro typ ovládacího prvku Okno. V model UI Automation je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splňovat, aby bylo možné vlastnost použítControlTypeProperty. Podmínky zahrnují specifické pokyny pro strukturu stromové struktury model UI Automation, model UI Automation hodnoty vlastností a vzory ovládacích prvků.
Ovládací prvek okna se skládá z rámečku okna, který obsahuje podřízené objekty, jako je záhlaví, klient a další objekty.
Požadavky model UI Automation v následujících částech platí pro všechny ovládací prvky, které implementují typ ovládacího prvku Okno, ať už Windows Presentation Foundation (WPF), Win32 nebo model Windows Forms.
Požadovaná struktura stromu model UI Automation
Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu model UI Automation, které se týká ovládacích prvků oken, a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu model UI Automation naleznete v tématu model UI Automation Strom přehledu.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| Okno | Okno |
Požadované vlastnosti model UI Automation
V následující tabulce jsou uvedeny vlastnosti model UI Automation, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky okna. Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| AutomationIdProperty | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná pro všechny ovládací prvky v aplikaci. |
| BoundingRectangleProperty | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| ClickablePointProperty | Viz poznámky. | Ovládací prvek okna musí mít kliknutelný bod, který způsobí, že okno bude vybráno nebo nevybrané. |
| ControlTypeProperty | Okno | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| IsContentElementProperty | True | Ovládací prvek okna musí být vždy obsahem. |
| IsControlElementProperty | True | Ovládací prvek okna musí být vždy ovládací prvek. |
| IsKeyboardFocusableProperty | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| LabeledByProperty | null |
Ovládací prvky okna nemají statický popisek okna. |
| LocalizedControlTypeProperty | "window" | Lokalizovaný řetězec odpovídající typu ovládacího prvku Okno. |
| NameProperty | Viz poznámky. | Ovládací prvek okna vždy obsahuje primární prvek Okna, který se vztahuje k tomu, co by uživatel přidružil jako sémantický identifikátor položky. |
Požadované vzory ovládacích prvků model UI Automation
Následující tabulka uvádí model UI Automation vzory ovládacích prvků vyžadované ovládacími prvky oken. Další informace o vzorech ovládacích prvků najdete v tématu model UI Automation Přehled vzorů ovládacích prvků.
| Vzor ovládacího prvku | Technická podpora | Notes |
|---|---|---|
| IDockProvider | Podmíněné | Pokud má okno možnost ukotvit, musí být podporováno. |
| ITransformProvider | Požaduje se | Umožňuje přesunutí, změnu velikosti nebo otočení okna na obrazovce. |
| IWindowProvider | Požaduje se | Povolí konkrétní operace pro okno. |
Požadované události model UI Automation
Následující tabulka uvádí model UI Automation události, které musí být podporovány všemi ovládacími prvky okna. Další informace oudálostch model UI Automation ch
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| AsyncContentLoadedEvent | Požaduje se | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| LayoutInvalidatedEvent | Požaduje se | Nic |
| NameProperty událost změněná vlastností. | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |
| HorizontallyScrollableProperty událost změněná vlastností. | Závisí | Nic |
| HorizontalScrollPercentProperty událost změněná vlastností. | Závisí | Nic |
| HorizontalViewSizeProperty událost změněná vlastností. | Závisí | Nic |
| VerticalScrollPercentProperty událost změněná vlastností. | Závisí | Nic |
| VerticallyScrollableProperty událost změněná vlastností. | Závisí | Nic |
| VerticalViewSizeProperty událost změněná vlastností. | Závisí | Nic |
| WindowClosedEvent | Požaduje se | Nic |
| WindowOpenedEvent | Požaduje se | Nic |
| WindowVisualStateProperty událost změněná vlastností. | Závisí | Nic |