Stöd för användargränssnittsautomatisering för kontrolltypen TitleBar

Anmärkning

Den här dokumentationen är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i System.Windows.Automation namnrymd. 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 för titellisten representerar rubriker eller kapitelstänger 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 titelraden, oavsett om Windows Presentation Foundation (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
Titelrad

- Meny (0 eller 1)
- Knapp (0 eller mer)
Ej tillämpbart. (namnlistkontrollen har inget 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 Noteringar
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. Begränsningsrektangeln för en titelrad 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, bör du åsidosätta och ange 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 titellisten har vanligtvis ingen etikett.
ControlTypeProperty Titelrad Det här värdet är detsamma för alla gränssnittsramverk.
LocalizedControlTypeProperty titelrad Lokaliserad sträng som motsvarar kontrolltypen TitleBar.
IsContentElementProperty Falsk Kontrollen för namnlisten innehåller aldrig något innehåll.
IsControlElementProperty Sann Kontrollfältet för namnlisten måste alltid vara en kontroll.
IsOffscreenProperty Det beror på 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 acceleratortangenter.
AccessKeyProperty "" Kontrollen för titelrad 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 UI Automation Events Overview.

UI Automation-händelse Stöd Noteringar
BoundingRectangleProperty egenskapsändringshändelse. Krävs Ingen
IsOffscreenProperty egenskapsändringshändelse. Krävs Ingen
IsEnabledProperty egenskapsändringshändelse. Aldrig Ingen
AutomationFocusChangedEvent Aldrig Ingen
StructureChangedEvent Krävs Ingen

Se även