Stöd för användargränssnittsautomatisering för knappbeskrivningskontrolltypen
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 Knappbeskrivning. 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.
Knappbeskrivningskontroller är popup-fönster som innehåller text.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen ToolTip. Kraven för automatisering av användargränssnittet gäller för alla knappbeskrivningskontroller, oavsett om det gäller Windows Presentation Foundation (WPF), Win32 eller Windows Forms.
Obligatorisk trädstruktur för användargränssnittsautomatisering
I följande tabell visas kontrollvyn och innehållsvyn för UI Automation-trädet som gäller för verktygstipskontroller 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 |
|---|---|
| Tooltip - Text (0 eller mer) - Bild (0 eller mer) |
Tooltip |
Knappbeskrivningskontroller visas bara i innehållsvyn i UI Automation-trädet om de kan få tangentbordsfokus. Annars är all information om verktygstipset tillgänglig från HelpTextProperty UI Automation-elementet som verktygstipset refererar till.
Verktygstips bör visas under kontrollen som deras information refererar till. Klienter måste lyssna efter för ToolTipOpenedEvent att säkerställa att de konsekvent hämtar information som finns i verktygstips.
Nödvändiga egenskaper för UI Automation
I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för verktygstipskontroller. 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. | Den yttersta rektangeln som innehåller hela kontrollen. |
| ClickablePointProperty | Se anteckningar. | Den klickbara punkten ska vara den del av verktygsspetsen som stänger kontrollen. Vissa verktygstips har inte den här möjligheten och kommer inte att ha en klickbar punkt. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Se anteckningar. | Namnet på knappbeskrivningskontrollen är den text som visas i verktygstipset. |
| LabeledByProperty | Null |
Verktygstipskontroller är alltid självmärkta av innehållet. |
| ControlTypeProperty | Tooltip | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "verktygsspets" | Lokaliserad sträng som motsvarar kontrolltypen Knappbeskrivning. |
| IsContentElementProperty | Beror | Om knappbeskrivningskontrollen kan få tangentbordsfokus måste den finnas i trädinnehållsvyn. Om det bara är text är det tillgängligt som HelpTextProperty från kontrollen som aktiverade den. |
| IsControlElementProperty | Sant | Verktygsspetskontrollen måste alltid vara en kontroll. |
Nödvändiga UI Automation-kontrollmönster
I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av knappbeskrivningskontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| IWindowProvider | Beror | Verktygstips som kan stängas genom att klicka på ett användargränssnittsobjekt måste ha stöd för WindowPattern så att de kan stängas automatiskt. |
| ITextProvider | Beror | För bättre hjälpmedel kan en knappbeskrivningskontroll stödja textkontrollmönstret, även om det inte krävs. Textkontrollmönstret är användbart när texten har rtF-format och attribut (till exempel färg, fetstil och kursiv stil). |
Nödvändiga UI Automation-händelser
Knappbeskrivningskontroller måste höja ToolTipOpenedEvent när de visas på skärmen. Händelsen innehåller en referens till UI Automation-elementet i själva verktygstipset.
I följande tabell visas de UI Automation-händelser som krävs för att stödjas av alla knappbeskrivningskontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| TextSelectionChangedEvent | Beror | Ingen |
| TextChangedEvent | Beror | Ingen |
| WindowClosedEvent | Beror | Ingen |
| WindowOpenedEvent | Beror | Ingen |
| ToolTipOpenedEvent | Obligatoriskt | Ingen |
| ToolTipClosedEvent | Obligatoriskt | Ingen |
| 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. | Obligatoriskt | Ingen |
| NameProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| WindowVisualStateProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |