Stöd för användargränssnittsautomatisering för dokumentkontrolltypen
Kommentar
Den här dokumentationen System.Windows.Automation är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i namnområdet. Den senaste informationen om UI Automation finns i Windows Automation API: UI Automation.
Det här avsnittet innehåller information om stöd för UI Automation för dokumentkontrolltypen. I UI Automation är en kontrolltyp en uppsättning villkor som en kontroll måste uppfylla för att kunna använda egenskapen ControlTypeProperty . Villkoren omfattar specifika riktlinjer för UI Automation-trädstruktur, UI Automation-egenskapsvärden och kontrollmönster.
Dokumentkontroller låter en användare visa och ändra flera sidor med text. Till skillnad från redigeringskontroller som bara stöder en enkel rad med oformaterad text kan dokumentkontroller vara värdar för text som är formaterad och formaterad.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för dokumentkontrolltypen. Kraven för användargränssnittsautomatisering gäller för alla dokumentkontroller, oavsett om det gäller Windows Presentation Foundation (WPF), Win32 eller Windows Forms.
Obligatorisk trädstruktur för användargränssnittsautomatisering
I följande tabell visas kontrollvyn och innehållsvyn för UI Automation-trädet som gäller dokumentkontroller och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i Översikt över UI Automation Tree.
| Kontrollvy | Innehållsvy |
|---|---|
| Dokument -Varierar |
Dokument -Varierar |
Nödvändiga egenskaper för UI Automation
I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för dokumentkontroller. Mer information om egenskaper för UI Automation finns i UI Automation Properties for Clients (Egenskaper för gränssnittsautomatisering för klienter).
| UI Automation-egenskap | Värde | Kommentar |
|---|---|---|
| AutomationIdProperty | Se anteckningar. | Värdet för den här egenskapen måste vara unikt för alla kontroller i ett program. |
| BoundingRectangleProperty | Se anteckningar. | Den yttersta rektangeln som innehåller hela kontrollen. |
| ClickablePointProperty | Se anteckningar. | Dokumentet har en klickbar punkt som gör att dokumentet för ett av dess element i dokumentcontainern har fokus. |
| ControlTypeProperty | Dokument | Det här värdet är detsamma för alla gränssnittsramverk. |
| IsContentElementProperty | Sant | Dokumentkontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Dokumentkontrollen ingår alltid i kontrollvyn för UI Automation-trädet. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| LabeledByProperty | Se anteckningar. | Värdet för den här egenskapen ska vara dokumentkontrollens etikett. Vanligtvis används dokumentets rubrik. |
| LocalizedControlTypeProperty | "dokument" | Lokaliserad sträng som motsvarar dokumentkontrolltypen. |
| NameProperty | Se anteckningar. | Dokumentkontrollen hämtar vanligtvis sina namn från det filnamn som den läses in från. Detta visas ofta i ett innehållande fönster eller ramrubrik. |
Nödvändiga UI Automation-kontrollmönster
I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av dokumentkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| IScrollProvider | Beror | Dokumentkontrollen kan sträcka sig över större än det intervallet för visningsporten. Kontrollen bör ha stöd för rullningskontrollmönstret om innehållet är rullningsbart. |
| ITextProvider | Obligatoriskt | Dokumentkontrollen kan sträcka sig över större än det intervallet för visningsporten. Kontrollen bör ha stöd för rullningskontrollmönstret om innehållet är rullningsbart. |
| IValueProvider | Aldrig | Dokumentkontrollen stöder inte det här kontrollmönstret eftersom innehållet i kontrollen ofta sträcker sig över mer än en sida. UI Automation-klienter bör använda TextPattern för att hämta textinformation om ett dokument. |
Nödvändiga UI Automation-händelser
I följande tabell visas de UI Automation-händelser som krävs för att stödjas av alla dokumentkontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| BoundingRectangleProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsEnabledProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsOffscreenProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Ingen |
| HorizontallyScrollableProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| HorizontalScrollPercentProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| HorizontalViewSizeProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| VerticalScrollPercentProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| VerticallyScrollableProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| VerticalViewSizeProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| InvalidatedEvent | Beror | Om kontrollen stöder mönstret Markeringskontroll måste den ha stöd för den här händelsen. |
| TextSelectionChangedEvent | Obligatoriskt | Ingen |
| TextChangedEvent | Obligatoriskt | Ingen |
| ValueProperty händelse som ändrats av egenskapen. | Aldrig | Inga |