Ui Automation-ondersteuning voor het vensterbesturingstype
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 vensterbesturing. 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.
Het venster besturingselement bestaat uit het vensterframe, dat onderliggende objecten bevat, zoals titelbalk, client en andere objecten.
De vereisten voor ui-automatisering in de volgende secties zijn van toepassing op alle besturingselementen die het type vensterbesturingselement implementeren, 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 vensterbesturingselementen en wordt beschreven wat er in elke weergave kan worden opgenomen. Zie Overzicht van ui-automatiseringsstructuur voor meer informatie over de UI Automation-structuur.
| Besturingselementweergave | Inhoudsweergave |
|---|---|
| Venster | Venster |
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor vensterbesturingselementen. 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 venster besturingselement moet een klikbaar punt hebben waardoor het venster wordt geselecteerd of uitgeschakeld. |
| ControlTypeProperty | Venster | Deze waarde is hetzelfde voor alle UI-frameworks. |
| IsContentElementProperty | Waar | Het venster besturingselement moet altijd inhoud zijn. |
| IsControlElementProperty | Waar | Het venster besturingselement moet altijd een besturingselement zijn. |
| IsKeyboardFocusableProperty | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
| LabeledByProperty | null |
Vensterbesturingselementen hebben geen statisch vensterlabel. |
| LocalizedControlTypeProperty | "venster" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype Venster. |
| NameProperty | Zie notities. | Het venster besturingselement bevat altijd een primair vensterelement dat betrekking heeft op wat de gebruiker zou koppelen als de meest semantische id voor het item. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door vensterbesturingselementen. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IDockProvider | Voorwaardelijk | Moet worden ondersteund als het venster de mogelijkheid heeft om te worden gedokt. |
| ITransformProvider | Vereist | Hiermee kunt u het venster verplaatsen, het formaat ervan wijzigen of draaien op het scherm. |
| IWindowProvider | Vereist | Hiermee schakelt u specifieke bewerkingen voor het venster in. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle vensterbesturingselementen. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| AsyncContentLoadedEvent | Vereist | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| LayoutInvalidatedEvent | Vereist | Geen |
| NameProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| StructureChangedEvent | Vereist | Geen |
| HorizontallyScrollableProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| HorizontalScrollPercentProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| HorizontalViewSizeProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| VerticalScrollPercentProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| VerticallyScrollableProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| VerticalViewSizeProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| WindowClosedEvent | Vereist | Geen |
| WindowOpenedEvent | Vereist | Geen |
| WindowVisualStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | None |