Ui Automation-ondersteuning voor het besturingselementtype ToolTip
Notitie
Deze documentatie is bedoeld voor .NET Framework-ontwikkelaars die de beheerde UI Automation-klassen willen gebruiken die zijn gedefinieerd in de System.Windows.Automation naamruimte. Zie Windows Automation-API: UI Automation voor de meest recente informatie over UI Automation.
Dit onderwerp bevat informatie over ui Automation-ondersteuning voor het besturingselementtype ToolTip. In UI Automation is een besturingselementtype een set voorwaarden waaraan een besturingselement moet voldoen om de ControlTypeProperty eigenschap te kunnen gebruiken. De voorwaarden omvatten specifieke richtlijnen voor de structuur van de UI Automation-structuur, waarden voor UI Automation-eigenschappen en besturingspatronen.
Besturingselementen voor knopinfo zijn pop-upvensters die tekst bevatten.
In de volgende secties wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen gedefinieerd voor het besturingselementtype ToolTip. De vereisten voor UI Automation zijn van toepassing op alle besturingselementen voor knopinfo, ongeacht of Windows Presentation Foundation (WPF), Win32 of Windows Forms.
Vereiste structuur van ui-automatiseringsstructuur
In de volgende tabel ziet u de besturingsweergave en de inhoudsweergave van de UI Automation-structuur die betrekking heeft op besturingselementen voor knopinfo en wordt beschreven wat in elke weergave kan worden opgenomen. Zie Overzicht van ui-automatiseringsstructuur voor meer informatie over de UI Automation-structuur.
| Besturingselementweergave | Inhoudsweergave |
|---|---|
| Tooltip - Tekst (0 of meer) - Afbeelding (0 of meer) |
Tooltip |
Besturingselementen voor knopinfo worden alleen weergegeven in de inhoudsweergave van de ui-automatiseringsstructuur als ze de toetsenbordfocus kunnen ontvangen. Anders is alle informatie over de knopinfo beschikbaar via het HelpTextProperty element UI Automation waarnaar de knopinfo verwijst.
Knopinfo moet worden weergegeven onder het besturingselement waarnaar de informatie verwijst. Clients moeten luisteren naar de ToolTipOpenedEvent informatie om ervoor te zorgen dat ze consistent informatie verkrijgen in tooltips.
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor besturingselementen voor knopinfo. Zie Eigenschappen van UI Automation voor clients voor meer informatie over eigenschappen van UI Automation.
| Ui Automation-eigenschap | Weergegeven als | Opmerkingen |
|---|---|---|
| AutomationIdProperty | Zie notities. | De waarde van deze eigenschap moet uniek zijn voor alle besturingselementen in een toepassing. |
| BoundingRectangleProperty | Zie notities. | De buitenste rechthoek die het hele besturingselement bevat. |
| ClickablePointProperty | Zie notities. | Het klikbare punt moet het deel zijn van de knopinfo waarmee het besturingselement wordt gesloten. Sommige tips voor hulpprogramma's hebben deze mogelijkheid niet en hebben geen klikbaar punt. |
| IsKeyboardFocusableProperty | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
| NameProperty | Zie notities. | De naam van het besturingselement knopinfo is de tekst die in de knopinfo wordt weergegeven. |
| LabeledByProperty | Null |
Besturingselementen voor knopinfo worden altijd zelf gelabeld door hun inhoud. |
| ControlTypeProperty | Tooltip | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "knopinfo" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype ToolTip. |
| IsContentElementProperty | Hangt | Als het besturingselement voor knopinfo de toetsenbordfocus kan ontvangen, moet deze zich in de inhoudsweergave van de structuur bevindt. Als het alleen tekst is, is deze beschikbaar als HelpTextProperty van het besturingselement dat deze heeft gegenereerd. |
| IsControlElementProperty | Waar | Het besturingselement voor knopinfo moet altijd een besturingselement zijn. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door besturingselementen voor knopinfo. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IWindowProvider | Hangt | Knopinfo die kan worden gesloten door op een UI-item te klikken, moet WindowPattern ondersteunen, zodat deze automatisch kunnen worden gesloten. |
| ITextProvider | Hangt | Voor een betere toegankelijkheid kan een besturingselement voor knopinfo het tekstbesturingspatroon ondersteunen, hoewel dit niet vereist is. Het patroon Tekstbeheer is handig wanneer de tekst opmaakstijl en -kenmerken heeft (bijvoorbeeld kleur, vet en cursief). |
Vereiste UI Automation-gebeurtenissen
Besturingselementen voor knopinfo moeten het ToolTipOpenedEvent scherm verhogen wanneer ze worden weergegeven. De gebeurtenis bevat een verwijzing naar het element UI Automation van de knopinfo zelf.
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen voor knopinfo. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| TextSelectionChangedEvent | Hangt | Geen |
| TextChangedEvent | Hangt | Geen |
| WindowClosedEvent | Hangt | Geen |
| WindowOpenedEvent | Hangt | Geen |
| ToolTipOpenedEvent | Vereist | Geen |
| ToolTipClosedEvent | Vereist | Geen |
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| NameProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| WindowVisualStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |