Typ av fönsterkontroll
Det här avsnittet innehåller information om Microsoft UI Automation-stöd för kontrolltypen Window.
Fönsterkontrollen består av fönsterramen, som innehåller underordnade objekt som namnlist, klient och andra objekt.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för Window kontrolltyp. Kraven för användargränssnittsautomatisering gäller för alla fönsterkontroller 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
- 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 fönsterkontroller 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 fönsterkontroller. 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. | Fönsterkontrollen måste ha en klickbar punkt som gör att fönstret blir markerat eller avmarkerat. |
| UIA_ControlTypePropertyId | fönster | Det här värdet är detsamma för alla gränssnittsramverk. |
| UIA_IsContentElementPropertyId | SANN | Fönsterkontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| UIA_IsControlElementPropertyId | SANN | Fönsterkontrollen 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. |
| UIA_LabeledByPropertyId | NOLL | Fönsterkontroller har ingen statisk fönsteretikett. |
| UIA_LocalizedControlTypePropertyId | Se anteckningar. | Lokaliserad sträng som motsvarar kontrolltypen Window. Standardvärdet är "window" för en-US eller engelska (USA). |
| UIA_NamePropertyId | Se anteckningar. | Fönsterkontrollen innehåller alltid ett primärt fönsterelement som relaterar till vad användaren skulle associera som den mest semantiska identifieraren för objektet. |
Nödvändiga kontrollmönster
I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av fönsterkontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.
| Kontrollmönster/mönsteregenskap | Support/värde | Anteckningar |
|---|---|---|
| IDockProvider | Villkorlig | Kontrollmönstret Dock måste stödjas om fönstret kan dockas. |
| ITransformProvider | Krävs | Kontrollmönstret Transformera gör att fönstret kan flyttas, ändras eller roteras på skärmen. (Gäller inte för Windows Store-appar.) |
| IWindowProvider | Krävs | Kontrollmönstret window aktiverar specifika åtgärder för fönstret. |
Nödvändiga händelser
I följande tabell visas de UI Automation-händelser som window kontroller krävs för att stödja. Mer information om händelser finns i UI Automation Events Overview.
| UI Automation-händelse | Anteckningar |
|---|---|
| UIA_AsyncContentLoadedEventId | |
| 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_LayoutInvalidatedEventId | |
| UIA_NamePropertyId händelse som ändrats av egenskapen. | |
| UIA_ScrollHorizontallyScrollablePropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen. |
| UIA_ScrollHorizontalScrollPercentPropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen. |
| UIA_ScrollHorizontalViewSizePropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen. |
| UIA_ScrollVerticallyScrollablePropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen. |
| UIA_ScrollVerticalScrollPercentPropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen. |
| UIA_ScrollVerticalViewSizePropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen. |
| UIA_StructureChangedEventId | |
| UIA_Window_WindowClosedEventId | |
| UIA_Window_WindowOpenedEventId | |
| UIA_WindowWindowVisualStatePropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder egenskapen WindowVisualState för kontrollmönstret Window måste den här händelsen stödjas. |
Relaterade ämnen
-
konceptuell
-
översikt över UI Automation-kontrolltyper
-
översikt över UI Automation