Stöd för användargränssnittsautomatisering för kontrolltypen TitleBar
Kommentar
Den här dokumentationen System.Windows.Automation är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i namnområdet. Den senaste informationen om UI Automation finns i Windows Automation API: UI Automation.
Det här avsnittet innehåller information om stöd för UI Automation för kontrolltypen TitleBar. I UI Automation är en kontrolltyp en uppsättning villkor som en kontroll måste uppfylla för att kunna använda egenskapen ControlTypeProperty . Villkoren innehåller specifika riktlinjer för UI Automation-trädstruktur, UI Automation-egenskapsvärden och kontrollmönster.
Kontroller i namnlisten representerar rubriker eller bildtext staplar i ett fönster.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen TitleBar. UI Automation-kraven gäller för alla kontroller i namnlisten, oavsett om windows presentationsstiftelsen (WPF), Win32 eller Windows Forms.
Obligatorisk trädstruktur för användargränssnittsautomatisering
Följande tabell visar kontrollvyn och innehållsvyn för UI Automation-trädet som gäller för kontroller i namnlisten och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i Översikt över UI Automation Tree.
| Kontrollvy | Innehållsvy |
|---|---|
| Namnlisten - Meny (0 eller 1) - Knapp (0 eller mer) |
Ej tillämpbart. (kontrollen för namnlisten saknar innehåll.) |
Nödvändiga egenskaper för UI Automation
I följande tabell visas de UI Automation-egenskaper vars värde eller definition är särskilt relevant för TitleBar-kontroller. Mer information om egenskaper för UI Automation finns i UI Automation Properties for Clients (Egenskaper för gränssnittsautomatisering för klienter).
| UI Automation-egenskap | Värde | Kommentar |
|---|---|---|
| AutomationIdProperty | Se anteckningar. | Värdet för den här egenskapen måste vara unikt för alla kontroller i ett program. |
| BoundingRectangleProperty | Se anteckningar. | Avgränsningsrektangeln för ett namnlist måste omfatta alla kontroller som finns i den. |
| ClickablePointProperty | Se anteckningar. | Stöds om det finns en rektangel för avgränsning. Om inte varje punkt i avgränsningsrektangeln är klickbar och du utför specialiserad träfftestning åsidosätter du och anger en klickbar punkt. |
| IsKeyboardFocusableProperty | Falsk | Rubrikstaplar har aldrig tangentbordsfokus. |
| NameProperty | "" | Namnlisten är inte innehåll. dess textinformation visas i det överordnade fönstret. |
| LabeledByProperty | Se anteckningar. | Kontrollen för namnlisten har vanligtvis ingen etikett. |
| ControlTypeProperty | Namnlisten | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "namnlist" | Lokaliserad sträng som motsvarar kontrolltypen TitleBar. |
| IsContentElementProperty | Falsk | Kontrollen för namnlisten är aldrig innehåll. |
| IsControlElementProperty | Sant | Kontrollen för namnlisten måste alltid vara en kontroll. |
| IsOffscreenProperty | Beror | Den här kontrollen returnerar ett värde beroende på om namnlisten visas på skärmen. |
| HelpTextProperty | "" | Det är inte nödvändigt att exponera hjälptexten. |
| AcceleratorKeyProperty | "" | Namnlister har aldrig acceleratornycklar. |
| AccessKeyProperty | "" | Kontrollen för namnlisten har ingen åtkomstnyckel. |
Nödvändiga UI Automation-kontrollmönster
Kontrolltypen TitleBar krävs inte för att stödja några kontrollmönster. Dess funktioner exponeras via windows-kontrollmönstret i fönsterkontrollen.
Nödvändiga UI Automation-händelser
I följande tabell visas de UI Automation-händelser som krävs för att stödjas av alla kontroller i namnlisten. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| BoundingRectangleProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsOffscreenProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsEnabledProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| AutomationFocusChangedEvent | Aldrig | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |