SplitButton-kontrolltyp
Det här avsnittet innehåller information om Microsoft UI Automation-stöd för kontrolltypen SplitButton.
Med delningsknappen kan en åtgärd utföras 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 SplitButton kontrolltyp. Kraven för UI Automation gäller för alla delade 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
- relevanta egenskaper
- nödvändiga kontrollmönster
- nödvändiga händelser
- Exempel på för SplitButton-kontrolltyp
- Relaterade ämnen
Typisk trädstruktur
I följande tabell visas en typisk kontroll- och innehållsvy över 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 |
|---|---|
|
|
Relevanta egenskaper
I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för SplitButton kontrolltyp. 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_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 | SplitButton | Det här värdet är detsamma för alla gränssnittsramverk. |
| UIA_HelpTextPropertyId | Se anteckningar. | Hjälptexten kan indikera resultatet av att aktivera delningsknappen, vilket vanligtvis är samma typ av information som visas via en knappbeskrivning. |
| UIA_IsContentElementPropertyId | SANN | Delningsknappen innehåller information för slutanvändaren. |
| UIA_IsControlElementPropertyId | SANN | Delningsknappens kontroll är synlig för slutanvändaren. |
| UIA_IsKeyboardFocusablePropertyId | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| UIA_LabeledByPropertyId | NOLL | Kontrollerna för delad knapp har ingen statisk textetikett. |
| UIA_LocalizedControlTypePropertyId | Se anteckningar. | Lokaliserad sträng som motsvarar SplitButton kontrolltyp. Standardvärdet är "split button" för en-US eller engelska (USA). |
| UIA_NamePropertyId | Se anteckningar. | Texten som används för att märka delningsknappen. När en bild används för att märka en delningsknapp måste alternativ text anges för split button Name-egenskapen. |
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 kontroller med delade knappar. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.
| Kontrollmönster | Stöd | Anteckningar |
|---|---|---|
| IExpandCollapseProvider | Krävs | Eftersom delade knappar alltid har möjlighet att expandera en lista med alternativ måste de ha stöd för ExpandCollapse kontrollmönstret. |
| IInvokeProvider | Krävs | Eftersom delade knappar alltid har en standardåtgärd associerad med metoden IInvokeProvider::Invoke måste de ha stöd för kontrollmönstret Invoke. |
Nödvändiga händelser
I följande tabell visas de UI Automation-händelser som delade 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_ExpandCollapseExpandCollapseStatePropertyId händelse som ändrats av egenskapen. | |
| UIA_Invoke_InvokedEventId | |
| 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_StructureChangedEventId |
Exempel på SplitButton-kontrolltyp
Följande bild visar en kontroll som implementerar SplitButton kontrolltyp.
| Träd för gränssnittsautomatisering – kontrollvy | Träd för gränssnittsautomatisering – innehållsvy |
|---|---|
|
|
Relaterade ämnen
-
konceptuell
-
översikt över UI Automation-kontrolltyper
-
översikt över UI Automation