Ui Automation-ondersteuning voor het type tekstbesturing
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 tekstbesturing. 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.
Tekstbesturingselementen zijn het basisitem van de gebruikersinterface dat een stuk tekst op het scherm vertegenwoordigt.
In de volgende secties wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type tekstbesturingselement gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle tekstbesturingselementen, 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 tekstbesturingselementen 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 |
|---|---|
| Sms verzenden | Tekst (indien inhoud) |
Een tekstbesturingselement kan alleen worden gebruikt als label of als statische tekst op een formulier. Deze kan ook worden opgenomen in de structuur van een:
ListItem
TreeItem
DataItem
Tekstbesturingselementen bevinden zich mogelijk niet in de inhoudsweergave van de ui-automatiseringsstructuur, omdat tekst vaak wordt weergegeven via een NameProperty ander besturingselement. De tekst die wordt gebruikt om een besturingselement keuzelijst met invoervak te labelen, wordt bijvoorbeeld weergegeven via de waarde van NameProperty het besturingselement. Omdat het besturingselement Keuzelijst met invoervak zich in de inhoudsweergave van de UI Automation-structuur bevindt, is het niet nodig dat het tekstbesturingselement daar is. Tekstbesturingselementen hebben altijd 0 onderliggende items in de inhoudsweergave
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor tekstbesturingselementen. 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. | Ondersteund als er een begrenzingsrechthoek is. Als niet elk punt in de begrenzingsrechthoek kan worden geklikt en u gespecialiseerde hittests uitvoert, overschrijft en geeft u een klikbaar punt op. |
| 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 besturingselement voor de tekstbalk is altijd de txt die wordt weergegeven. |
| LabeledByProperty | Null |
Tekstbesturingselementen hebben geen statisch tekstlabel. |
| ControlTypeProperty | Sms verzenden | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "tekst" | Gelokaliseerde tekenreeks die overeenkomt met het type tekstbesturingselement. |
| IsContentElementProperty | Hangt | Het tekst besturingselement is inhoud als het informatie bevat die niet beschikbaar is in nameproperty van een ander besturingselement. |
| IsControlElementProperty | Waar | Het tekst besturingselement moet altijd een besturingselement zijn. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door tekstbesturingselementen. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IValueProvider | Nooit | Text biedt nooit ondersteuning voor ValuePattern. Als de tekst bewerkbaar is, is dit het besturingselementtype Bewerken. |
| ITextProvider | Hangt | Tekst moet het tekstbeheerpatroon ondersteunen voor betere toegankelijkheid; het is echter niet vereist. Het patroon Tekstbeheer is handig wanneer de tekst opmaakstijl en -kenmerken heeft (bijvoorbeeld kleur, vet en cursief). Is afhankelijk van het framework. |
| ITableItemProvider | Hangt | Als het tekstelement zich in een tabel besturingselement bevindt, moet dit worden ondersteund. |
| IRangeValueProvider | Hangt | Als het tekstelement zich in een tabel besturingselement bevindt, moet dit worden ondersteund. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle tekstbesturingselementen. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| TextSelectionChangedEvent | Vereist | Geen |
| TextChangedEvent | Vereist | 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 |
| ValueProperty eigenschap gewijzigd gebeurtenis. | Nooit | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |