Ui Automation-ondersteuning voor het type afbeeldingsbeheer
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 type afbeeldingsbeheer. 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 afbeeldingen die worden gebruikt als pictogrammen, informatieve afbeeldingen en grafieken ondersteunen het type afbeeldingsbesturingselement. Besturingselementen die worden gebruikt als achtergrondafbeeldingen of watermerkafbeeldingen ondersteunen het type afbeeldingsbesturingselement niet.
In de volgende secties wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type afbeeldingsbesturingselement gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle besturingselementen voor afbeeldingen, 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 afbeeldingen 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 |
|---|---|
| Image | Afbeelding (is afhankelijk van of de afbeelding informatie bevat (op basis van de waarde van IsContentElement de eigenschap)) |
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor het type afbeeldingsbeheer. 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 van het besturingselement van de afbeelding moet een punt zijn binnen de begrenzingsrechthoek van het besturingselement afbeelding. |
| IsKeyboardFocusableProperty | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
| NameProperty | Zie notities. | De eigenschap Name moet worden weergegeven voor alle besturingselementen voor afbeeldingen die informatie bevatten. Voor programmatische toegang tot deze informatie moet een tekstueel equivalent van de afbeelding worden opgegeven. Als het besturingselement voor afbeeldingen puur decoratief is, moet het alleen worden weergegeven in de besturingsweergave van de UI Automation-structuur en hoeft deze geen naam te hebben. UI-frameworks moeten een alternatieve teksteigenschap of alternatieve teksteigenschap ondersteunen voor afbeeldingen die vanuit hun framework kunnen worden ingesteld. Deze eigenschap wordt vervolgens toegewezen aan de eigenschap UI Automation Name. |
| LabeledByProperty | Zie notities. | Als er een statisch tekstlabel is, moet deze eigenschap een verwijzing naar dat besturingselement weergeven. |
| ControlTypeProperty | Image | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "afbeelding" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype Afbeelding. |
| IsContentElementProperty | Zie notities. | Het afbeeldingsbesturingselement moet worden opgenomen in de inhoudsweergave van de UI Automation-structuur wanneer het zinvolle informatie bevat die nog niet beschikbaar is voor de eindgebruiker. |
| IsControlElementProperty | Waar | Het afbeeldingsbesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
| HelpTextProperty | Zie notities. | Met de eigenschap HelpText wordt een gelokaliseerde tekenreeks weergegeven die het werkelijke uiterlijk van het besturingselement beschrijft (bijvoorbeeld een rood vierkant met een witte X) of andere informatie over knopinfo die aan de afbeelding is gekoppeld. Deze eigenschap moet worden ondersteund wanneer een lange beschrijving nodig is om meer informatie over het besturingselement voor afbeeldingen over te brengen. Bijvoorbeeld een gecompliceerd diagram of diagram. Deze eigenschap wordt toegewezen aan de HTML LongDesc-tag en de SVG-tag (Scalable Vector Graphics). Ontwikkelaars die met besturingselementen voor installatiekopieën werken, moeten ondersteuning bieden voor een eigenschap, zodat de beschrijving van de visual kan worden ingesteld op het besturingselement. Deze eigenschap moet worden toegewezen aan de eigenschap UI Automation VisualDescription. |
| ItemStatusProperty | Zie notities. | Als het afbeeldingsbeheer staat voor statusinformatie over een bepaald item op het scherm, moet het besturingselement zich in het item bevinden. Wanneer de afbeelding zich in een item bevindt, moet het item de statuseigenschap ondersteunen en de juiste meldingen genereren wanneer de status wordt gewijzigd. Als een afbeelding een zelfstandig besturingselement is en de status van deze eigenschap aangeeft, moet deze eigenschap worden ondersteund. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door alle besturingselementen voor installatiekopieën. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IGridItemProvider | Hangt | Het afbeeldingsbeheer ondersteunt het rasteritempatroon als het besturingselement zich in een rastercontainer bevindt. |
| ITableItemProvider | Hangt | Het afbeeldingsbesturingselement ondersteunt het patroon Tabelitem als het besturingselement zich in een container bevindt met headerbesturingselementen. |
| IInvokeProvider | Nooit | Als het besturingselement afbeelding een klikbare afbeelding bevat, moet het besturingselement een besturingselementtype ondersteunen dat het aanroeppatroon ondersteunt, zoals het besturingselement Knop. |
| ISelectionItemProvider | Nooit | Afbeeldingsbesturingselementen mogen het patroon Selectie-item niet ondersteunen. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen voor installatiekopieën. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| InvokedEvent | Nooit | Geen |
| ElementAddedToSelectionEvent | Nooit | Geen |
| ElementRemovedFromSelectionEvent | Nooit | Geen |
| ElementSelectedEvent | Nooit | 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 |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |