Dela via

Stöd för UI Automation för kontrolltypen SplitButton

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 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 UI Automation Tree Overview.

Kontrollvy Innehållsvy
SplitButton

  • Bild (0 eller 1)
  • Text (0 eller 1)
  • Knapp (1 eller 2)

    • Meny (0 eller 1; visas som underordnad knapp som stöder ExpandCollapse-mönster)
    • MenuItem (1 till många)
 SplitButton

- Menyalternativ (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 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.
IsKeyboardFocusableProperty Se anteckningar. Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen.
NameProperty "Tillbaka" Delningsknappkontrollens namn visas på knappen.
LabeledByProperty Noll 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 Sann Delningsknappen innehåller information för slutanvändaren.
IsControlElementProperty Sann 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 UI Automation Control Patterns Overview.

Kontrollmönster Stöd Noteringar
IInvokeProvider Krävs Delningsknappar har alltid en standardåtgärd som är associerad med Invoke.
IExpandCollapseProvider Krävs 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 UI Automation Events Overview.

UI Automation-händelse Stöd Noteringar
InvokedEvent Krävs Ingen
BoundingRectangleProperty egenskap-ändrad händelse. Krävs Ingen
IsOffscreenProperty egenskap-ändrad händelse. Krävs Ingen
IsEnabledProperty egenskap-ändrad händelse. Krävs Ingen
ExpandCollapseStateProperty egenskap-ändrad händelse. Krävs Ingen
AutomationFocusChangedEvent Krävs Ingen
StructureChangedEvent Krävs Ingen

Exempel på SplitButton-kontroll

Följande bild visar en SplitButton-kontrolltyp i en datarutnätskontroll.

Delningsknapp

Kontrollvyn och innehållsvyn för UI Automation-trädet som gäller kontrollerna för datagaller och delad knapp 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
  • SplitButton "Namn" (Aktivera, Expandera/Kollapsa)
  • Knapp "Fler alternativ" (invovera)

    • Meny
    • Menyobjekt
    • …
  • SplitButton "Namn" (Aktivera, Expandera/Kollapsa)
  • Knapp "Fler alternativ" (invovera)

    • Meny
    • Menyobjekt
    • …

Se även

  • Last updated on