Stöd för användargränssnittsautomatisering för redigeringskontrolltypen
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 kontrolltypen Redigera. 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.
Med redigeringskontroller kan en användare visa och redigera en enkel textrad utan stöd för rtF-formatering.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen Redigera. Kraven för användargränssnittsautomatisering gäller för alla redigeringskontroller, 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 för att redigera kontroller 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 |
|---|---|
| Redigera | Redigera |
De kontroller som implementerar kontrolltypen Redigera har alltid noll rullningslister i kontrollvyn för UI Automation-trädet eftersom det är en enradig kontroll. En enda textrad kan radbrytas i vissa layoutscenarier. Kontrolltypen Redigera passar bäst för att lagra små mängder redigerbar eller valbar text.
Nödvändiga egenskaper för UI Automation
I följande tabell visas de UI Automation-egenskaper vars värde eller definition är särskilt relevant för att redigera kontroller. 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. | Redigeringskontrollen måste ha en klickbar punkt som ger indata fokus på redigeringsdelen av kontrollen när en användare klickar med musen där. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Se anteckningar. | Namnet på redigeringskontrollen genereras vanligtvis från en statisk textetikett. Om det inte finns en statisk textetikett måste ett egenskapsvärde för Name tilldelas av programutvecklaren. Egenskapen Name får aldrig innehålla textinnehållet i redigeringskontrollen. |
| LabeledByProperty | Se anteckningar. | Om det finns en statisk textetikett som är associerad med kontrollen måste den här egenskapen exponera en referens till den kontrollen. Om textkontrollen är en underkomponent för en annan kontroll har LabeledBy den ingen egenskapsuppsättning. |
| ControlTypeProperty | Redigera | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "redigera" | Lokaliserad sträng som motsvarar kontrolltypen Redigera. |
| IsContentElementProperty | Sant | Redigeringskontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Redigeringskontrollen ingår alltid i kontrollvyn för UI Automation-trädet. |
| IsPasswordProperty | Se anteckningar. | Måste anges till true för redigeringskontroller som innehåller lösenord. Om en redigeringskontroll innehåller lösenordsinnehåll kan den här egenskapen användas av en skärmläsare för att avgöra om tangenttryckningar ska läsas upp när användaren skriver dem. |
Obligatoriska UI Automation-kontrollmönster och egenskaper
I följande tabell visas de kontrollmönster som krävs för att stödjas av alla redigeringskontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Egenskapen Kontrollmönster/kontrollmönster | Support/värde | Kommentar |
|---|---|---|
| ITextProvider | Beror | Redigeringskontroller bör ha stöd för textkontrollmönstret eftersom detaljerad textinformation alltid ska vara tillgänglig för klienter. |
| IValueProvider | Beror | Alla redigeringskontroller som tar en sträng måste exponera värdemönstret. |
| IsReadOnly | Se anteckningar. | Den här egenskapen måste anges för att ange om kontrollen kan ha en värdeuppsättning programmatiskt eller kan redigeras av användaren. |
| Value | Se anteckningar. | Den här egenskapen returnerar textinnehållet i redigeringskontrollen. Om är inställt på IsPasswordPropertytruemåste den här egenskapen generera en InvalidOperationException när den begärs. |
| IRangeValueProvider | Beror | Alla redigeringskontroller som tar ett numeriskt intervall måste exponera kontrollmönstret för intervallvärde. |
| Minimum | Se anteckningar. | Den här egenskapen måste vara det minsta värde som redigeringskontrollens innehåll kan anges till. |
| Maximum | Se anteckningar. | Den här egenskapen måste vara det största värdet som redigeringskontrollens innehåll kan anges till. |
| SmallChange | Se anteckningar. | Den här egenskapen måste ange antalet decimaler som värdet kan anges till. Om redigeringen bara tar heltal måste vara SmallChangeProperty 1. Om redigeringen tar ett intervall från 1.0 till 2.0 måste den SmallChangeProperty vara 0.1. Om redigeringskontrollen tar ett intervall från 1,00 till 2,00 måste den SmallChangeProperty vara 0,001. |
| LargeChange | Null |
Den här egenskapen behöver inte exponeras för en redigeringskontroll. |
| Value | Se anteckningar. | Den här egenskapen anger det numeriska innehållet i redigeringskontrollen. När ett mer exakt värde anges av en UI Automation-klient inom de intervall som anges i Minimum egenskaperna och Maximum avrundas egenskapen Value automatiskt till närmaste godkända värde. |
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 redigeringskontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| InvalidatedEvent | Obligatoriskt | Ingen |
| 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. | Beror | Ingen |
| HorizontallyScrollableProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| HorizontalScrollPercentProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| HorizontalViewSizeProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| VerticalScrollPercentProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| VerticallyScrollableProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| VerticalViewSizeProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| ValueProperty händelse som ändrats av egenskapen. | Beror | Om kontrollen stöder värdekontrollmönstret för intervall måste den ha stöd för den här händelsen. |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |