Ui Automation-ondersteuning voor het groepsbeheertype
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 groepsbeheertype. 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 UI Automation-besturingspatronen.
Het groepsbeheer vertegenwoordigt een knooppunt in een hiërarchie. Het groepsbesturingselementtype maakt een scheiding in de UI Automation-structuur, zodat items die zijn gegroepeerd, een logische verdeling hebben binnen de UI Automation-structuur.
In de volgende secties worden de vereiste structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het groepsbesturingselementtype gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle groepsbesturingselementen, 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 groepsbesturingselementen 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 |
|---|---|
| Groep - 0 of veel besturingselementen |
Groep - 0 of veel besturingselementen |
Groepsbesturingselementen hebben doorgaans de ondersteuning voor ui-automatisering voor het type ListItem-besturingselement, UI Automation-ondersteuning voor het treeItem-besturingselementtype of UI Automation-ondersteuning voor de besturingstypen voor gegevensitem-besturingselementen die eronder zijn gevonden in de substructuur. Omdat 'Groep' een algemene container is, is het mogelijk dat elk type besturingselement zich onder het groepsbesturingselement in de structuur bevindt.
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor groepsbesturingselementen. 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. | Het groepsbeheer krijgt doorgaans de naam van de tekst die het besturingselement labelt. |
| LabeledByProperty | Zie notities. | Groepsbesturingselementen zijn doorgaans zelflabeling. In deze gevallen keert u hier terug null . Als er een statisch tekstlabel voor de groep is, moet deze worden geretourneerd als de waarde van de eigenschap LabeledBy. |
| ControlTypeProperty | Groep | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "groep" | Gelokaliseerde tekenreeks die overeenkomt met het groepsbesturingselementtype. |
| IsContentElementProperty | Waar | Het groepsbesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Waar | De agendagroep wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund voor het groepsbeheertype. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IExpandCollapseProvider | Hangt | Groepsbesturingselementen die kunnen worden gebruikt om informatie weer te geven of te verbergen, moeten het patroon Samenvouwen uitvouwen ondersteunen. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle groepsbesturingselementen. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| ExpandCollapseStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| ToggleStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |