Stöd för UI Automation för kontrolltypen SplitButton
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 kontrolltypen SplitButton. 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.
Med delningsknappen kan du utföra en åtgärd på en kontroll och expandera kontrollen för att se en lista över andra möjliga åtgärder som kan utföras.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen SplitButton. Kraven för användargränssnittsautomatisering gäller för alla delade knappkontroller, 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 avser delade knappkontroller 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 |
|---|---|
SplitButton
|
SplitButton - MenuItem (1 till många) |
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 delade knappkontroller. 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 | "Tillbaka" | Delningsknappens namn visas på knappen. |
| LabeledByProperty | Null | Kontrollerna för delad knapp har ingen statisk textetikett. |
| ControlTypeProperty | SplitButton | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "delningsknapp" | Lokaliserad sträng som motsvarar kontrolltypen SplitButton. |
| HelpTextProperty | Se anteckningar. | Hjälptexten kan indikera resultatet av att aktivera delningsknappen, vilket vanligtvis är samma typ av information som visas via en knappbeskrivning. |
| IsContentElementProperty | Sant | Delningsknappen innehåller information för slutanvändaren. |
| IsControlElementProperty | Sant | Delningsknappens kontroll är synlig för slutanvändaren. |
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 delade knappkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| IInvokeProvider | Obligatoriskt | Delningsknappar har alltid en standardåtgärd som är associerad med Invoke. |
| IExpandCollapseProvider | Obligatoriskt | Delningsknappar har alltid möjlighet att expandera en lista med alternativ. |
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 delade knappkontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| InvokedEvent | 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 |
| ExpandCollapseStateProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Ingen |
Exempel på SplitButton-kontroll
Följande bild visar en SplitButton-kontrolltyp i en datarutnätskontroll.
Kontrollvyn och innehållsvyn för UI Automation-trädet som gäller för kontrollerna för datarutnät och delningsknapp visas nedan. Kontrollmönstren för varje automationselement visas inom parenteser.
| Träd för gränssnittsautomatisering – kontrollvy | Träd för gränssnittsautomatisering – innehållsvy |
|---|---|
|
|