Not
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Anmärkning
Den här dokumentationen är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i System.Windows.Automation namnrymd. 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 redigeringskomponenter som bara stöder en enkel rad med oformaterad text, kan dokumentkomponenter hantera text som är rikt stiliserad 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 UI Automation Tree Overview.
| 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 | Noteringar |
|---|---|---|
| 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 | Sann | Dokumentkontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sann | 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 UI Automation Control Patterns Overview.
| Kontrollmönster | Stöd | Noteringar |
|---|---|---|
| IScrollProvider | Det beror på | 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 | Krävs | 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 UI Automation Events Overview.
| UI Automation-händelse | Stöd | Noteringar |
|---|---|---|
| AutomationFocusChangedEvent | Krävs | Ingen |
| BoundingRectangleProperty egenskapsändringshändelse. | Krävs | Ingen |
| IsEnabledProperty egenskapsändringshändelse. | Krävs | Ingen |
| IsOffscreenProperty egenskapsändringshändelse. | Krävs | Ingen |
| StructureChangedEvent | Krävs | Ingen |
| HorizontallyScrollableProperty egenskapsändringshändelse. | Krävs | Ingen |
| HorizontalScrollPercentProperty egenskapsändringshändelse. | Krävs | Ingen |
| HorizontalViewSizeProperty egenskapsändringshändelse. | Krävs | Ingen |
| VerticalScrollPercentProperty egenskapsändringshändelse. | Krävs | Ingen |
| VerticallyScrollableProperty egenskapsändringshändelse. | Krävs | Ingen |
| VerticalViewSizeProperty egenskapsändringshändelse. | Krävs | Ingen |
| InvalidatedEvent | Det beror på | Om kontrollen stöder Markeringskontrollmönstret måste den stödja denna händelse. |
| TextSelectionChangedEvent | Krävs | Ingen |
| TextChangedEvent | Krävs | Ingen |
| ValueProperty egenskapsändringshändelse. | Aldrig | Ingen |
Se även
- Document
- översikt över typer av UI Automation-kontroller
- översikt över UI Automation