Kontrolltyp för AppBar
Det här avsnittet innehåller information om Microsoft UI Automation-stöd för AppBar kontrolltyp.
Ett appfält är ett gränssnittselement som visar navigering, kommandon och verktyg för användaren. För Windows Store-appar kan appstaplar för appar visas genom att trycka på Windows-tangenten + Z.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för AppBar kontrolltyp.
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 gäller för AppBar kontroller och beskriver vad som kan finnas i varje vy. Button är det vanligaste elementet i en AppBar- men andra kontroller som anropar åtgärder för en app är också möjliga. En AppBar- kan också ha 0 eller fler avgränsare (Avgränsare kontrolltyp), som visas i kontrollvyn enligt de andra kontrollerna. 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 de kontroller som implementerar AppBar 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. | Värdet som exponeras av den här egenskapen måste innehålla alla kontroller som finns i den. |
| UIA_ControlTypePropertyId | AppBar | |
| UIA_IsContentElementPropertyId | FALSK | En appfältkontroll ingår inte i innehållsvyn i UI Automation-trädet. |
| UIA_IsControlElementPropertyId | SANN | En appfältkontroll ingår alltid i kontrollvyn för UI Automation-trädet. |
| UIA_IsKeyboardFocusablePropertyId | Se anteckningar | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. Kontroller i appfältet kan vanligtvis fokusera på tangentbordet. |
| UIA_IsOffscreenPropertyId | Se anteckningar. | Värdet för den här egenskapen beror på om kontrollen kan visas på skärmen. |
| UIA_LabeledByPropertyId | Noll | Appfältkontroller har vanligtvis ingen etikett. |
| UIA_LocalizedControlTypePropertyId | Se anteckningar. | Lokaliserad sträng som motsvarar AppBar kontrolltyp. Standardvärdet är "appbar" för en-US eller engelska (USA). |
| UIA_NamePropertyId | Se anteckningar. | Kontrollen för appfältet behöver inte ett namn om inte ett program har fler än ett appfält. Om det finns fler än ett appfält i ett program använder du den här egenskapen för att exponera unika namn, till exempel "Top" eller "Bottom". |
Nödvändiga händelser
I följande tabell visas de UI Automation-händelser som appfältkontroller 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 |
Relevanta händelser
I följande tabell visas de UI Automation-händelser som är särskilt relevanta för de kontroller som implementerar AppBar- kontrolltyp men som inte är absolut nödvändiga.
| UI Automation-händelse | Anteckningar |
|---|---|
| UIA_MenuClosedEventId | Plattformsimplementeringar kan utlösa den här händelsen när appfältets kontroll stängs. |
| UIA_MenuOpenedEventId | Plattformsimplementeringar kan utlösa den här händelsen när appfältets kontroll öppnas. |
| IUIAutomationPropertyChangedEventHandler | Händelsehanterare för ändrade egenskaper. |
Relaterade ämnen
-
konceptuell
-
översikt över UI Automation-kontrolltyper
-
översikt över UI Automation
-
referens