Kontrolltyp för knappbeskrivning
Det här avsnittet innehåller information om Microsoft UI Automation-stöd för ToolTip- kontrolltyp. 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 ToolTip kontrolltyp. Kraven för användargränssnittsautomatisering gäller för alla knappbeskrivningskontroller 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 avser knappbeskrivningskontroller 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 |
|---|---|
|
|
Knappbeskrivningskontroller visas bara i innehållsvyn i UI Automation-trädet om de kan få tangentbordsfokus. Annars är all knappbeskrivningsinformation tillgänglig från egenskapen IUIAutomationElement::CurrentHelpText (eller CachedHelpText) för elementet som knappbeskrivningen refererar till.
Knappbeskrivningar bör visas under den kontroll som deras information refererar till. Klienter måste lyssna efter UIA_ToolTipOpenedEventId för att säkerställa att de konsekvent hämtar information som finns i knappbeskrivningar.
Relevanta egenskaper
I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för ToolTip- 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. | Den yttersta rektangeln som innehåller hela kontrollen. |
| UIA_ClickablePointPropertyId | Se anteckningar. | Den klickbara punkten ska vara den del av knappbeskrivningen som stänger kontrollen. Vissa knappbeskrivningar har inte den här möjligheten och har ingen klickbar punkt. |
| UIA_ControlTypePropertyId | Knappbeskrivning | |
| UIA_IsContentElementPropertyId | Beror | Om knappbeskrivningskontrollen kan få tangentbordsfokus måste den visas i innehållsvyn i trädet. Om det bara är text är den tillgänglig som egenskapen IUIAutomationElement::CurrentHelpText (eller CachedHelpText) från kontrollen som aktiverade den. |
| UIA_IsControlElementPropertyId | Sann | Knappbeskrivningskontrollen 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 | Knappbeskrivningskontroller är alltid självmärkta av innehållet. |
| UIA_LocalizedControlTypePropertyId | Se anteckningar. | Lokaliserad sträng som motsvarar kontrolltypen Knappbeskrivning. Standardvärdet är "knappbeskrivning" för en-US eller engelska (USA). |
| UIA_NamePropertyId | Se anteckningar. | Namnet på knappbeskrivningskontrollen är den text som visas i knappbeskrivningen. |
Nödvändiga 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 UI Automation Control Patterns Overview.
| Kontrollmönster | Stöd | Anteckningar |
|---|---|---|
| ITextProvider | Beror | För bättre hjälpmedel kan en knappbeskrivningskontroll stödja kontrollmönstret Text, ä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). |
| IWindowProvider | Beror | Knappbeskrivningar som kan stängas genom att klicka på ett användargränssnittsobjekt måste ha stöd för Fönster kontrollmönster så att de kan stängas automatiskt. |
Nödvändiga händelser
Knappbeskrivningskontroller måste höja UIA_ToolTipOpenedEventId händelsen när de visas på skärmen. Händelsen innehåller en referens till UI Automation-elementet i själva knappbeskrivningen.
I följande tabell visas de UI Automation-händelser som knappbeskrivningskontroller 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_NamePropertyId händelse som ändrats av egenskapen. | |
| UIA_Text_TextChangedEventId | Om kontrollen stöder kontrollmönstret Text måste den ha stöd för den här händelsen. |
| UIA_ToolTipClosedEventId | |
| UIA_ToolTipOpenedEventId | |
| UIA_StructureChangedEventId | |
| UIA_Window_WindowClosedEventId | Om kontrollen stöder kontrollmönstret Window måste den ha stöd för den här händelsen. |
| UIA_Window_WindowOpenedEventId | Om kontrollen stöder kontrollmönstret Window måste den ha stöd för den här händelsen. |
| UIA_WindowWindowVisualStatePropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder kontrollmönstret Window måste den ha stöd för den här händelsen. |
Relaterade ämnen
-
konceptuell
-
översikt över UI Automation-kontrolltyper
-
översikt över UI Automation