Dela via

Stöd för användargränssnittsautomatisering för kombinationsrutans kontrolltyp

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 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 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 kombinationsrutekontroller 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
Kombinationsruta

– Redigera (0 eller 1)
- Lista (1)
- Listobjekt (underordnad lista; 0 till många)
- Knapp (1)		 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 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. 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, bör du åsidosätta och ange en klickbar punkt.
ControlTypeProperty 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 Sann Kombinationsrutekontroller ingår alltid i innehållsvyn i UI Automation-trädet.
IsControlElementProperty Sann Kombinationsrutekontroller ingår alltid i kontrollvyn för UI Automation-trädet.
IsKeyboardFocusableProperty Sann Kombinationsrutekontroller visar objekt från en valcontainer. 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 UI Automation Control Patterns Overview.

Kontrollmönster Stöd Noteringar
IExpandCollapseProvider Ja Kontrollknappen för kombinationsrutan måste alltid innehålla rullgardinsknappen 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 Det beror på 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 av en kombinationsruta. Det är möjligt om en listruta i en kombinationsruta kan scrollas. 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 UI Automation Events Overview.

UI Automation-händelse Stöd Noteringar
AutomationFocusChangedEvent Krävs Ingen
BoundingRectangleProperty egenskapsändringshändelse. Krävs Ingen
IsOffscreenProperty egenskapsändringshändelse. Krävs Ingen
IsEnabledProperty egenskapsändringshändelse. Krävs Ingen
StructureChangedEvent Krävs Ingen
ExpandCollapseStateProperty egenskapsändringshändelse. Krävs Ingen
ValueProperty egenskapsändringshändelse. Det beror på Om kontrollen stöder värdemönstret måste den ha stöd för den här händelsen.

Se även

  • Last updated on