Stöd för användargränssnittsautomatisering för textkontrolltypen
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 textkontrolltypen. 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 innehåller specifika riktlinjer för UI Automation-trädstruktur, UI Automation-egenskapsvärden och kontrollmönster.
Textkontroller är det grundläggande användargränssnittsobjektet som representerar ett stycke text på skärmen.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för textkontrolltypen. Kraven för användargränssnittsautomatisering gäller för alla textkontroller, oavsett om det gäller Windows Presentation Foundation (WPF), Win32 eller Windows Forms.
Obligatorisk trädstruktur för användargränssnittsautomatisering
Följande tabell visar kontrollvyn och innehållsvyn för UI Automation-trädet som gäller textkontroller 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 |
|---|---|
| Text | Text (om innehåll) |
En textkontroll kan användas ensam som en etikett eller som statisk text i ett formulär. Den kan också ingå i strukturen för en:
ListItem
TreeItem
Dataitem
Textkontroller kanske inte finns i innehållsvyn i UI Automation-trädet eftersom text ofta visas via NameProperty en annan kontroll. Till exempel exponeras texten som används för att märka en Kombinationsruta-kontroll via kontrollens NameProperty värde. Eftersom kombinationsrutekontrollen finns i innehållsvyn i UI Automation Tree är det inte nödvändigt att textkontrollen finns där. Textkontroller har alltid 0 underordnade objekt i innehållsvyn
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 textkontroller. 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. | Stöds om det finns en rektangel för avgränsning. Om inte varje punkt i avgränsningsrektangeln är klickbar och du utför specialiserad träfftestning åsidosätter du och anger en klickbar punkt. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Se anteckningar. | Textfältkontrollens namn är alltid den txt som visas. |
| LabeledByProperty | Null |
Textkontroller har ingen statisk textetikett. |
| ControlTypeProperty | Text | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "text" | Lokaliserad sträng som motsvarar textkontrolltypen. |
| IsContentElementProperty | Beror | Textkontrollen kommer att vara innehåll om den innehåller information som inte exponeras i en annan kontrolls NameProperty. |
| IsControlElementProperty | Sant | Textkontrollen måste alltid vara en kontroll. |
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 textkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| IValueProvider | Aldrig | Text stöder aldrig ValuePattern. Om texten är redigerbar är det här kontrolltypen Redigera. |
| ITextProvider | Beror | Text bör ha stöd för textkontrollmönstret för bättre tillgänglighet. Det är dock inte nödvändigt. Textkontrollmönstret är användbart när texten har rtF-format och attribut (till exempel färg, fetstil och kursiv stil). Beror på ramverk. |
| ITableItemProvider | Beror | Om textelementet finns i en tabellkontroll måste detta stödjas. |
| IRangeValueProvider | Beror | Om textelementet finns i en tabellkontroll måste detta stödjas. |
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 textkontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| TextSelectionChangedEvent | Obligatoriskt | Ingen |
| TextChangedEvent | Obligatoriskt | Ingen |
| BoundingRectangleProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsOffscreenProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsEnabledProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| NameProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| ValueProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |