Delen via

Ui Automation-ondersteuning voor het documentbesturingstype

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 documentbeheertype. 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 boomstructuur van UI Automation, UI Automation-eigenschapswaarden en controlepatronen.

Met documentbesturingselementen kan een gebruiker meerdere pagina's met tekst bekijken en bewerken. In tegenstelling tot bewerkingsbesturingselementen die alleen een eenvoudige regel met niet-opgemaakte tekst ondersteunen, kunnen documentbesturingselementen tekst hosten die rijkelijk gestyled en opgemaakt is.

In de volgende secties worden de vereiste UI Automation-boomstructuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type besturingselement Document gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle documentbesturingselementen, ongeacht of 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 documentbesturingselementen en wordt beschreven wat in elke weergave kan worden opgenomen. Zie OVERZICHT van ui-automatiseringsstructuurvoor meer informatie over de UI Automation-structuur.

Controleweergave Inhoudsweergave
Document

-Varieert		 Document

-Varieert

Vereiste eigenschappen van UI Automation

De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor documentbesturingselementen. Zie UI Automation-eigenschappen voor cliënten voor meer informatie over UI Automation-eigenschappen.

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 document heeft een klikbaar punt waardoor het document van een van de elementen in de documentcontainer de focus heeft.
ControlTypeProperty Document Deze waarde is hetzelfde voor alle UI-frameworks.
IsContentElementProperty Klopt Het documentbesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur.
IsControlElementProperty Klopt Het documentbesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur.
IsKeyboardFocusableProperty Zie notities. Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen.
LabeledByProperty Zie notities. De waarde van deze eigenschap moet het label van het documentbesturingselement zijn. Normaal gesproken wordt de titel van het document gebruikt.
LocalizedControlTypeProperty "document" Gelokaliseerde tekenreeks die overeenkomt met het type documentbesturingselement.
NameProperty Zie notities. Het documentbeheer ontleent doorgaans zijn naam aan de bestandsnaam waarvan het geladen wordt. Dit wordt vaak weergegeven in een venster- of frametitel.

Vereiste patronen voor ui-automatiseringsbeheer

De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door documentbesturingselementen. Zie Overzicht van ui-automatiseringspatronenvoor meer informatie over besturingspatronen.

Besturingselementpatroon Ondersteuning Opmerkingen
IScrollProvider Dat hangt ervan af. Het documentbeheer kan groter zijn dan dat van de viewport. Het besturingselement moet het scroll-controlepatroon ondersteunen als de inhoud scrollbaar is.
ITextProvider Verplicht Het documentbeheer kan groter zijn dan dat van de viewport. Het besturingselement moet het scroll-controlepatroon ondersteunen als de inhoud scrollbaar is.
IValueProvider Nooit Het documentcontrole-element ondersteunt dit besturingselement niet omdat de inhoud van het besturingselement vaak meerdere pagina's omvat. UI Automation-clients zouden TextPattern moeten gebruiken om tekstinformatie over een document te verkrijgen.

Vereiste UI Automation-gebeurtenissen

De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle documentbesturingselementen. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.

Ui Automation-gebeurtenis Ondersteuning Opmerkingen
AutomationFocusChangedEvent Verplicht Geen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
StructureChangedEvent Verplicht Geen
HorizontallyScrollableProperty eigenschapswijziging-evenement. Verplicht Geen
HorizontalScrollPercentProperty eigenschapswijziging-evenement. Verplicht Geen
HorizontalViewSizeProperty eigenschapswijziging-evenement. Verplicht Geen
VerticalScrollPercentProperty eigenschapswijziging-evenement. Verplicht Geen
VerticallyScrollableProperty eigenschapswijziging-evenement. Verplicht Geen
VerticalViewSizeProperty eigenschapswijziging-evenement. Verplicht Geen
InvalidatedEvent Dat hangt ervan af. Als het besturingselement het selectiebeheerpatroon ondersteunt, moet het deze gebeurtenis ondersteunen.
TextSelectionChangedEvent Verplicht Geen
TextChangedEvent Verplicht Geen
ValueProperty eigenschapswijziging-evenement. Nooit Geen

Zie ook

  • Last updated on