Stöd för användargränssnittsautomatisering för kombinationsrutans kontrolltyp
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 UI Automation-stöd för kombinationsrutans kontrolltyp. 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, kontrollmönster och UI Automation-händelser.
En kombinationsruta är en listruta som kombineras med en statisk kontroll eller en redigeringskontroll som visar det markerade objektet i listrutan i kombinationsrutan. Listrutedelen av kontrollen visas hela tiden eller visas bara när användaren väljer listrutepilen (som är en push-knapp) bredvid kontrollen. Om markeringsfältet är en redigeringskontroll kan användaren ange information som inte finns i listan. Annars kan användaren bara välja objekt i listan.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kombinationsrutans kontrolltyp. Kraven för UI Automation gäller för alla kombinationsrutekontroller, oavsett om windows presentationsfundament (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 kombinationsrutekontroller 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 |
|---|---|
| ComboBox (Kombinationsruta) – Redigera (0 eller 1) - Lista (1) - Listobjekt (underordnad lista; 0 till många) - Knapp (1) |
ComboBox (Kombinationsruta) - Listobjekt (0 till många) |
Redigeringskontrollen i kombinationsrutans kontrollvy är bara nödvändig om kombinationsrutan kan redigeras för att ta några indata, vilket är fallet med kombinationsrutan i dialogrutan Kör.
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 kombinationsrutekontroller. 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. |
| ControlTypeProperty | ComboBox (Kombinationsruta) | Det här värdet är detsamma för alla gränssnittsramverk. |
| HelpTextProperty | Se anteckningar. | Hjälptexten för kombinationsrutekontroller bör förklara varför användaren uppmanas att välja ett alternativ i kombinationsrutan. Texten liknar information som presenteras via en knappbeskrivning. Till exempel "Välj ett objekt för att ange bildskärmens bildskärmsupplösning". |
| IsContentElementProperty | Sant | Kombinationsrutekontroller ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Kombinationsrutekontroller ingår alltid i kontrollvyn för UI Automation-trädet. |
| IsKeyboardFocusableProperty | Sant | Kombinationsrutekontroller exponerar en uppsättning objekt från en markeringscontainer. Kombinationsrutekontrollen kan få tangentbordsfokus, men när en UI Automation-klient fokuserar på en kombinationsruta kan alla objekt i kombinationsrutans underträd få fokus. |
| LabeledByProperty | Se anteckningar. | Kombinationsrutekontroller har vanligtvis en statisk textetikett som den här egenskapen refererar till. |
| LocalizedControlTypeProperty | "kombinationsruta" | Lokaliserad sträng som motsvarar kombinationsrutans kontrolltyp. |
| NameProperty | Se anteckningar. | Kombinationsrutekontrollen hämtar vanligtvis sitt namn från en statisk textkontroll. |
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 alla kombinationsrutekontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| IExpandCollapseProvider | Ja | Kombinationsrutekontrollen måste alltid innehålla listrutan för att vara en kombinationsruta. |
| ISelectionProvider | Ja | Visar den aktuella markeringen i kombinationsrutan. Det här stödet delegeras till listrutan under kombinationsrutan. |
| IValueProvider | Beror | Om kombinationsrutan har möjlighet att ta godtyckliga textvärden måste värdemönstret stödjas. Det här mönstret ger möjlighet att programmatiskt ange stränginnehållet i kombinationsrutan. Om värdemönstret inte stöds betyder det att användaren måste göra ett val från listobjekten i underträdet i kombinationsrutan. |
| IScrollProvider | Aldrig | Rullningsmönstret stöds aldrig direkt i en kombinationsruta. Det stöds om en listruta som finns i en kombinationsruta kan rulla. Det kan bara stödjas när listrutan visas på skärmen. |
Nödvändiga händelser
I följande tabell visas de UI Automation-händelser som krävs för att stödjas av alla kombinationsrutekontroller. 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 |
| IsOffscreenProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsEnabledProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Ingen |
| ExpandCollapseStateProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| ValueProperty händelse som ändrats av egenskapen. | Beror | Om kontrollen stöder värdemönstret måste den ha stöd för den här händelsen. |