Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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 bewerkingselementtype. 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.
Bewerkingsvelden stellen een gebruiker in staat een eenvoudige tekstregel weer te geven en te bewerken zonder ondersteuning voor rijke opmaak.
In de volgende secties definieert u de vereiste structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het besturingselementtype Bewerken. De vereisten voor UI Automation zijn van toepassing op alle besturingselementen voor bewerken, of het nu 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 het bewerken van besturingselementen en wordt beschreven wat in elke weergave kan worden opgenomen. Zie OVERZICHT van ui-automatiseringsstructuurvoor meer informatie over de UI Automation-structuur.
| Controleweergave | Inhoudsweergave |
|---|---|
| Bewerken | Bewerken |
De besturingselementen die het besturingselementtype Bewerken implementeren, hebben altijd nul schuifbalken in de besturingsweergave van de UI Automation-structuur, omdat het een besturingselement met één regel is. Een enkele regel tekst kan in sommige indelingsscenario's worden afgebroken. Het besturingselementtype Bewerken is het meest geschikt voor het bewaren van kleine hoeveelheden bewerkbare of selecteerbare tekst.
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 bewerken van besturingselementen. 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 besturingselement bewerken moet een klikbaar punt hebben dat de invoerfocus geeft aan het bewerkingsgedeelte van het besturingselement wanneer een gebruiker daar op de muis klikt. |
| 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 bewerkingsbesturingselement wordt meestal gegenereerd op basis van een statisch tekstlabel. Als er geen statisch tekstlabel is, moet een eigenschapswaarde Name worden toegewezen door de ontwikkelaar van de toepassing. De Name eigenschap mag nooit de tekstuele inhoud van het besturingselement bewerken bevatten. |
| LabeledByProperty | Zie notities. | Als er een statisch tekstlabel is gekoppeld aan het besturingselement, moet deze eigenschap een verwijzing naar dat besturingselement weergeven. Als het tekstbesturingselement een subcomponent is van een ander besturingselement, zal er geen LabeledBy-eigenschap ingesteld zijn. |
| ControlTypeProperty | Bewerken | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "bewerken" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype Bewerken. |
| IsContentElementProperty | Klopt | Het bewerkingsbesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Klopt | Het bewerkingsbesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
| IsPasswordProperty | Zie notities. | Moet worden ingesteld op true voor bewerkingsbesturingselementen die wachtwoorden bevatten. Als een bewerkingsveld wel wachtwoordinhoud bevat, kan deze eigenschap door een schermlezer worden gebruikt om te bepalen of toetsaanslagen moeten worden voorgelezen terwijl de gebruiker typt. |
Vereiste patronen en eigenschappen van ui-automatiseringsbeheer
De volgende tabel bevat de besturingspatronen die moeten worden ondersteund door alle besturingselementen voor bewerken. Zie Overzicht van ui-automatiseringspatronenvoor meer informatie over besturingspatronen.
| Control Pattern/Eigenschap Control Pattern | Ondersteuning/waarde | Opmerkingen |
|---|---|---|
| ITextProvider | Dat hangt ervan af. | Besturingselementen voor bewerken moeten het tekstbesturingselementpatroon ondersteunen, omdat gedetailleerde tekstinformatie altijd beschikbaar moet zijn voor clients. |
| IValueProvider | Dat hangt ervan af. | Alle bewerkingsbesturingselementen die een tekenreeks accepteren, moeten het waardepatroon beschikbaar maken. |
| IsReadOnly | Zie notities. | Deze eigenschap moet worden ingesteld om aan te geven of het besturingselement programmatisch een waardeset kan hebben of door de gebruiker kan worden bewerkt. |
| Value | Zie notities. | Deze eigenschap retourneert de tekstuele inhoud van het besturingselement bewerken. Als de IsPasswordProperty is ingesteld op true, moet deze eigenschap een InvalidOperationException veroorzaken wanneer daarom wordt gevraagd. |
| IRangeValueProvider | Dat hangt ervan af. | Alle bewerkingsbesturingselementen die een numeriek bereik vereisen, moeten het bereikwaarde controlepatroon weergeven. |
| Minimum | Zie notities. | Deze eigenschap moet de kleinste waarde zijn waarop de inhoud van het besturingselement kan worden ingesteld. |
| Maximum | Zie notities. | Deze eigenschap moet de grootste waarde zijn waarop de inhoud van het besturingselement kan worden ingesteld. |
| SmallChange | Zie notities. | Deze eigenschap moet het aantal decimalen aangeven waarop de waarde kan worden ingesteld. Als de bewerking alleen gehele getallen accepteert, moet de SmallChangeProperty waarde 1 zijn. Als de bewerking een bereik van 1,0 tot 2,0 heeft, moet de SmallChangeProperty 0,1 zijn. Als het bewerkingsbesturingselement een bereik van 1.00 tot 2.00 heeft, moet de SmallChangeProperty waarde 0,001 zijn. |
| LargeChange | Null |
Deze eigenschap hoeft niet beschikbaar te worden gesteld in een besturingselement voor bewerken. |
| Value | Zie notities. | Met deze eigenschap wordt de numerieke inhoud van het besturingselement bewerken aangegeven. Wanneer een nauwkeurigere waarde wordt ingesteld door een UI Automation-client binnen de bereiken die zijn opgegeven in de Minimum en Maximum eigenschappen, wordt de eigenschap Waarde automatisch afgerond op de dichtstbijzijnde geaccepteerde waarde. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen voor bewerken. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.
| UI-automatiseringsgebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| InvalidatedEvent | Verplicht | Geen |
| TextSelectionChangedEvent | Verplicht | Geen |
| TextChangedEvent | Verplicht | Geen |
| BoundingRectangleProperty eigenschapswijziging-evenement. | Verplicht | Geen |
| IsOffscreenProperty eigenschapswijziging-evenement. | Verplicht | Geen |
| IsEnabledProperty eigenschapswijziging-evenement. | Verplicht | Geen |
| NameProperty eigenschapswijziging-evenement. | Verplicht | Geen |
| ValueProperty eigenschapswijziging-evenement. | Dat hangt ervan af. | Geen |
| HorizontallyScrollableProperty eigenschapswijziging-evenement. | Nooit | Geen |
| HorizontalScrollPercentProperty eigenschapswijziging-evenement. | Nooit | Geen |
| HorizontalViewSizeProperty eigenschapswijziging-evenement. | Nooit | Geen |
| VerticalScrollPercentProperty eigenschapswijziging-evenement. | Nooit | Geen |
| VerticallyScrollableProperty eigenschapswijziging-evenement. | Nooit | Geen |
| VerticalViewSizeProperty eigenschapswijziging-evenement. | Nooit | Geen |
| ValueProperty eigenschapswijziging-evenement. | Dat hangt ervan af. | Als het besturingselement het waarde-bereikbesturingspatroon ondersteunt, moet het dit evenement ondersteunen. |
| AutomationFocusChangedEvent | Verplicht | Geen |
| StructureChangedEvent | Verplicht | Geen |
Zie ook
- Edit
- Overzicht van UI Automation-besturingstypen
- Overzicht van UI Automation