Ui Automation-ondersteuning voor het documentbesturingstype
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 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 structuur van de UI Automation-structuur, ui Automation-eigenschapswaarden en besturingspatronen.
Met documentbesturingselementen kan een gebruiker meerdere pagina's met tekst bekijken en bewerken. In tegenstelling tot besturingselementen bewerken die alleen een eenvoudige regel met niet-opgemaakte tekst ondersteunen, kunnen documentbesturingselementen tekst hosten die rijkelijk is opgemaakt en opgemaakt.
In de volgende secties wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het documentbesturingselementtype gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle documentbesturingselementen, 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 documentbesturingselementen 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 |
|---|---|
| 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 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 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 | Waar | Het documentbesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Waar | 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 haalt doorgaans de namen op van de bestandsnaam waaruit het wordt geladen. 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 Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IScrollProvider | Hangt | Het documentbeheer kan groter zijn dan dat van de viewport. Het besturingselement moet het scroll-besturingselementpatroon ondersteunen als de inhoud kan worden geschoven. |
| ITextProvider | Vereist | Het documentbeheer kan groter zijn dan dat van de viewport. Het besturingselement moet het scroll-besturingselementpatroon ondersteunen als de inhoud kan worden geschoven. |
| IValueProvider | Nooit | Dit besturingselement ondersteunt dit besturingselement niet omdat de inhoud van het besturingselement vaak meerdere pagina's omvat. UI Automation-clients moeten worden gebruikt TextPattern 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-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| AutomationFocusChangedEvent | Vereist | Geen |
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| StructureChangedEvent | Vereist | Geen |
| HorizontallyScrollableProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| HorizontalScrollPercentProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| HorizontalViewSizeProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| VerticalScrollPercentProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| VerticallyScrollableProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| VerticalViewSizeProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| InvalidatedEvent | Hangt | Als het besturingselement het selectiebeheerpatroon ondersteunt, moet het deze gebeurtenis ondersteunen. |
| TextSelectionChangedEvent | Vereist | Geen |
| TextChangedEvent | Vereist | Geen |
| ValueProperty eigenschap gewijzigd gebeurtenis. | Nooit | None |