Dela via

Knappkontrolltyp

  • Artikel

Det här avsnittet innehåller information om Microsoft UI Automation-stöd för Button kontrolltyp.

En knapp är ett objekt som en användare interagerar med för att utföra en åtgärd, till exempel knapparna OK och Avbryt i en dialogruta. Knappkontrollen är en enkel kontroll att exponera eftersom den mappar till ett enda kommando som användaren vill slutföra.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för Knapp kontrolltyp. Kraven för användargränssnittsautomatisering gäller för alla knappkontroller där UI-ramverket/plattformen integrerar UI Automation-stöd för kontrolltyper och kontrollmönster.

Det här avsnittet innehåller följande avsnitt.

Typisk trädstruktur

I följande tabell visas en typisk kontroll- och innehållsvy över UI Automation-trädet som avser 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
  • Knapp
    • Bild (0 eller mer)
    • Text (0 eller mer)
  • Knapp

 

Relevanta egenskaper

I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för de kontroller som implementerar Knapp kontrolltyp (till exempel knappkontroller). Mer information om egenskaper för UI Automation finns i Hämta egenskaper från UI Automation-element.

UI Automation-egenskap Värde Anteckningar
UIA_AcceleratorKeyPropertyId Se anteckningar. En knappkontroll stöder vanligtvis en acceleratornyckel så att slutanvändaren snabbt kan utföra åtgärden som representeras av knappen från tangentbordet.
UIA_AutomationIdPropertyId Se anteckningar. Värdet för den här egenskapen måste vara unikt bland alla peer-element i den råa vyn för UI Automation-trädet.
UIA_BoundingRectanglePropertyId Se anteckningar. Den yttersta rektangeln som innehåller hela kontrollen.
UIA_ClickablePointPropertyId Se anteckningar. Stöds om det finns en rektangel för avgränsning. Om inte varje punkt i avgränsningsrektangeln är klickbar och elementet utför specialiserad träfftestning åsidosätter och ger en klickbar punkt.
UIA_ControlTypePropertyId knapp
UIA_HelpTextPropertyId Se anteckningar. Hjälptexten bör ange vad slutresultatet av att aktivera knappen blir. Detta är vanligtvis samma typ av information som presenteras via en knappbeskrivning.
UIA_IsContentElementPropertyId SANN Knappkontrollen måste alltid vara innehåll.
UIA_IsControlElementPropertyId SANN Knappkontrollen måste alltid vara en kontroll.
UIA_IsKeyboardFocusablePropertyId Se anteckningar. Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen.
UIA_LabeledByPropertyId Noll Knappkontroller är självmärkta av innehållet.
UIA_LocalizedControlTypePropertyId Se anteckningar. Lokaliserad sträng som motsvarar -knappen kontrolltyp. Standardvärdet är "button" för en-US eller engelska (USA).
UIA_NamePropertyId Se anteckningar. Namnet på knappkontrollen är den text som används för att märka den. När en bild används för att märka en knapp måste alternativ text anges för knappens egenskap Namn.

 

Nödvändiga kontrollmönster

I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av alla knappkontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.

Kontrollmönster/mönsteregenskap Support/värde Anteckningar
IExpandCollapseProvider Se anteckningar. När en knapp hanteras som underordnad en delningsknapp kan den underordnade knappen stödja ExpandCollapse kontrollmönster i stället för Anropa eller Växla kontrollmönster. Kontrollmönstret ExpandCollapse kan användas för att öppna eller stänga en meny eller annan understruktur som är associerad med knappelementet.
IInvokeProvider Se anteckningar. Alla knappar bör ha stöd för Anropa kontrollmönster eller Växla kontrollmönster men inte båda. Mönstret Anropa kontroll måste stödjas när knappen utför ett kommando på begäran av användaren. Det här kommandot mappar till en enda åtgärd, till exempel Klipp ut, Kopiera, Klistra in eller Ta bort.
IToggleProvider Se anteckningar. Alla knappar bör ha stöd för Anropa kontrollmönster eller Växla kontrollmönster men inte båda. Växlingskontrollmönstret måste stödjas om knappen kan växla genom en serie med upp till tre tillstånd. Detta ses vanligtvis som en på/av-växel för specifika funktioner.

 

Nödvändiga händelser

I följande tabell visas de UI Automation-händelser som knappkontroller krävs för att stödja. Mer information om händelser finns i UI Automation Events Overview.

UI Automation-händelse Anteckningar
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId händelse som ändrats av egenskapen.
UIA_Invoke_InvokedEventId Om kontrollen stöder Anropa kontrollmönster måste den stödja den här händelsen.
UIA_IsEnabledPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder egenskapen IsEnabled måste den stödja den här händelsen.
UIA_IsOffscreenPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder egenskapen IsOffscreen måste den ha stöd för den här händelsen.
UIA_NamePropertyId händelse som ändrats av egenskapen.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder Växla kontrollmönster måste den stödja den här händelsen.

 

konceptuell

översikt över UI Automation-kontrolltyper

översikt över UI Automation