Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku dokument
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 Dokument. 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í prvky dokumentu umožňují uživateli zobrazit více stránek textu a manipulovat s nimi. Na rozdíl od ovládacích prvků pro úpravy, které podporují jenom jednoduchý řádek neformátovaného textu, můžou ovládací prvky dokumentu hostovat text, který je formátovaný a formátovaný.
Následující části definují požadovanou model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Dokument. Požadavky na model UI Automation platí pro všechny ovládací prvky dokumentu, 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 model UI Automation stromu, který se týká ovládacích prvků dokumentu, a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu model UI Automation najdete v tématu model UI Automation Stromový přehled.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| Dokument -Liší |
Dokument -Liší |
Požadované vlastnosti model UI Automation
Následující tabulka uvádí model UI Automation vlastnosti, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky dokumentu. 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. | Dokument má kliknoutelný bod, který způsobí, že dokument jednoho z jeho prvků v kontejneru dokumentů bude mít fokus. |
| ControlTypeProperty | Dokument | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| IsContentElementProperty | True | Ovládací prvek dokumentu je vždy součástí zobrazení obsahu model UI Automation stromu. |
| IsControlElementProperty | True | Ovládací prvek dokumentu je vždy součástí zobrazení ovládacího prvku model UI Automation stromu. |
| IsKeyboardFocusableProperty | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| LabeledByProperty | Viz poznámky. | Hodnota této vlastnosti by měla být popiskem ovládacího prvku dokumentu. Obvykle se používá název dokumentu. |
| LocalizedControlTypeProperty | "dokument" | Lokalizovaný řetězec odpovídající typu ovládacího prvku Dokument. |
| NameProperty | Viz poznámky. | Ovládací prvek dokumentu obvykle získává jeho názvy z názvu souboru, ze který je načten. To se často zobrazuje v názvu okna nebo rámečku. |
Požadované vzory ovládacích prvků model UI Automation
Následující tabulka uvádí model UI Automation vzory ovládacích prvků, které jsou potřeba k podpoře ovládacích prvků dokumentu. 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 |
|---|---|---|
| IScrollProvider | Závisí | Ovládací prvek dokumentu může být větší než toto rozpětí oblasti zobrazení. Ovládací prvek by měl podporovat vzor ovládacího prvku Scroll, pokud je obsah posouván. |
| ITextProvider | Požaduje se | Ovládací prvek dokumentu může být větší než toto rozpětí oblasti zobrazení. Ovládací prvek by měl podporovat vzor ovládacího prvku Scroll, pokud je obsah posouván. |
| IValueProvider | Nikdy | Ovládací prvek dokumentu nepodporuje tento vzor ovládacího prvku, protože obsah ovládacího prvku často pokrývá více než jednu stránku. model UI Automation klienti by měli použít TextPattern k získání textových informací o dokumentu. |
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 dokumentu. Další informace oudálostch model UI Automation ch
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| 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 |
| StructureChangedEvent | Požaduje se | Nic |
| HorizontallyScrollableProperty událost změněná vlastností. | Požaduje se | Nic |
| HorizontalScrollPercentProperty událost změněná vlastností. | Požaduje se | Nic |
| HorizontalViewSizeProperty událost změněná vlastností. | Požaduje se | Nic |
| VerticalScrollPercentProperty událost změněná vlastností. | Požaduje se | Nic |
| VerticallyScrollableProperty událost změněná vlastností. | Požaduje se | Nic |
| VerticalViewSizeProperty událost změněná vlastností. | Požaduje se | Nic |
| InvalidatedEvent | Závisí | Pokud ovládací prvek podporuje vzor ovládacího prvku Výběr, musí tuto událost podporovat. |
| TextSelectionChangedEvent | Požaduje se | Nic |
| TextChangedEvent | Požaduje se | Nic |
| ValueProperty událost změněná vlastností. | Nikdy | Nic |