Delen via

UI Automation-ondersteuning voor het type afbeeldingsbesturing

Opmerking

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 Automationvoor 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 als pictogrammen, informatieve afbeeldingen en grafieken worden gebruikt, zullen het type afbeeldingsbesturingselement ondersteunen. Besturingselementen die worden gebruikt als achtergrondafbeeldingen of watermerkafbeeldingen ondersteunen het type afbeeldingsbesturingselement niet.

In de volgende secties wordt de vereiste UI Automation boomstructuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type beeldcontrole gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle beeldbedieningselementen, ongeacht of het gaat om Windows Presentation Foundation (WPF), Win32 of Windows Forms.

Vereiste structuur voor UI-automatisering

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-automatiseringsstructuurvoor meer informatie over de UI Automation-structuur.

Controleweergave Inhoudsweergave
Afbeelding 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. Voor meer informatie over UI Automation-eigenschappen, zie UI Automation-eigenschappen voor cliënten.

UI Automation-eigenschap Waarde 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 aanklikbare punt van het afbeeldingsbesturingselement moet een punt zijn binnen de begrenzingsrechthoek van het afbeeldingsbesturingselement.
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 zichtbaar worden gemaakt 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 Afbeelding 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 Klopt 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 complex diagram of grafiek. Deze eigenschap komt overeen met de HTML LongDesc-tag en de Scalable Vector Graphics (SVG) Desc-tag. 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 geeft de UI Automation-besturingspatronen weer die door alle afbeeldingsbesturingselementen moeten worden ondersteund. Zie Overzicht van ui-automatiseringspatronenvoor meer informatie over besturingspatronen.

Besturingselementpatroon Ondersteuning Opmerkingen
IGridItemProvider Dat hangt ervan af. Het afbeeldingsbeheer ondersteunt het rasteritempatroon als het besturingselement zich in een rastercontainer bevindt.
ITableItemProvider Dat hangt ervan af. Het afbeeldingsbesturingselement ondersteunt het patroon Tabelitem als het besturingselement zich in een container bevindt met koptekstbesturingselementen.
IInvokeProvider Nooit Als het besturingselement een klikbare afbeelding bevat, moet het het besturingselementtype ondersteunen dat het Invoke-patroon 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 afbeeldingsbesturingselementen. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.

Ui Automation-gebeurtenis Ondersteuning Opmerkingen
InvokedEvent Nooit Geen
ElementAddedToSelectionEvent Nooit Geen
ElementRemovedFromSelectionEvent Nooit Geen
ElementSelectedEvent Nooit Geen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
NameProperty eigenschapswijziging-evenement. Verplicht Geen
AutomationFocusChangedEvent Verplicht Geen
StructureChangedEvent Verplicht Geen

Zie ook

  • Last updated on