Kontrolltyp för statusfältet
Det här avsnittet innehåller information om Microsoft UI Automation-stöd för kontrolltypen StatusBar.
En statusstapelkontroll visar information om ett objekt som visas i ett fönster i ett program, objektets komponent eller kontextuell information som relaterar till objektets åtgärd i ditt program.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för StatusBar kontrolltyp. Kraven för UI Automation gäller för alla statusfältkontroller 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
- kommentarer
- Relaterade ämnen
Typisk trädstruktur
I följande tabell visas en typisk kontroll- och innehållsvy över UI Automation-trädet som gäller för statusstapelkontroller 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 de UI Automation-egenskaper vars värde eller definition är särskilt relevant för statusfältets kontroller. 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. | Avgränsningsrektangeln för ett statusfält måste omfatta alla kontroller som finns i den. |
| UIA_ClickablePointPropertyId | Se anteckningar. | Stöds om det finns en rektangel för avgränsning. Om det finns områden inom avgränsningsrektangeln som inte kan klickas och elementet utför specialiserad träfftestning åsidosätter du detta och anger en klickbar punkt. |
| UIA_ControlTypePropertyId | StatusBar | |
| UIA_IsContentElementPropertyId | SANN | Statusfältets kontroll ingår alltid i innehållsvyn i UI Automation-trädet. |
| UIA_IsControlElementPropertyId | SANN | Statusstapelkontrollen ingår alltid i kontrollvyn för UI Automation-trädet. |
| UIA_IsKeyboardFocusablePropertyId | Beror | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| UIA_IsOffscreenPropertyId | Beror | Om en statusstapelkontroll inte visas för närvarande returneras TRUE för den här egenskapen. |
| UIA_LabeledByPropertyId | NOLL | Statusstapelkontrollen har vanligtvis ingen etikett. |
| UIA_LocalizedControlTypePropertyId | Se anteckningar. | Lokaliserad sträng som motsvarar StatusBar kontrolltyp. Standardvärdet är "statusfält" för en-US eller engelska (USA). |
| UIA_NamePropertyId | Se anteckningar. | Statusstapelkontrollen behöver inte ett namn om inte mer än ett används i ett program. I det här fallet särskiljer du varje stapel med namn som "Internetstatus" eller "programstatus". |
| UIA_OrientationPropertyId | Beror | Ett värde som anger kontrollens orientering: vågrätt eller lodrätt. |
Nödvändiga kontrollmönster
I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas för statusstapelkontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.
| Kontrollmönster | Stöd | Anteckningar |
|---|---|---|
| IGridProvider | Valfri | Statusstapelkontroller bör ha stöd för Grid kontrollmönster så att enskilda delar kan övervakas och enkelt refereras till för information. |
Nödvändiga händelser
I följande tabell visas de UI Automation-händelser som statusstapelkontroller 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_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 |
Anmärkningar
Vi rekommenderar att redigeringskontroller används som underordnade rutnätselement i ett statusfält. Genom att använda redigeringskontroller blir det enklare att associera syftet med statusfältet med dess värde med hjälp av elementnamnet och värdeegenskapen. Eftersom textkontroller inte bör ha stöd för värde kontrollmönster bör de inte användas som underordnade rutnätselement.
Relaterade ämnen
-
konceptuell
-
översikt över UI Automation-kontrolltyper
-
översikt över UI Automation