Het UI Automation ExpandCollapse-controlpatroon implementeren

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.

In dit onderwerp worden richtlijnen en conventies geïntroduceerd voor het implementeren van IExpandCollapseProvider, waaronder informatie over eigenschappen, methoden en gebeurtenissen. Koppelingen naar aanvullende verwijzingen worden weergegeven aan het einde van het overzicht.

Het ExpandCollapsePattern besturingspatroon wordt gebruikt ter ondersteuning van besturingselementen die visueel worden uitgevouwen om meer inhoud weer te geven en samen te vouwen om inhoud te verbergen. Zie Toewijzing van besturingspatronen voor UI Automation-clientsvoor voorbeelden van besturingselementen die dit besturingspatroon implementeren.

Implementatierichtlijnen en conventies

Let bij het implementeren van het expandcollapse-besturingspatroon op de volgende richtlijnen en conventies:

• Aggregatiebesturingselementen, gebouwd met onderliggende objecten die de gebruikersinterface voorzien van functionaliteit voor uitvouwen/samenvouwen, moeten het ExpandCollapsePattern besturingspatroon ondersteunen, terwijl hun onderliggende elementen dat niet doen. Een besturingselement voor een keuzelijstvak is bijvoorbeeld samengesteld uit een combinatie van keuzelijst, knop en bewerkingselementen, maar alleen het bovenliggende keuzelijstvak moet de ExpandCollapsePattern ondersteunen.

  Opmerking

  Een uitzondering hierop is het menu-besturingselement, een samenvoeging van afzonderlijke MenuItem-objecten. De MenuItem-objecten kunnen het ExpandCollapsePattern besturingspatroon ondersteunen, maar het bovenliggende menu-besturingselement kan dat niet. Een vergelijkbare uitzondering is van toepassing op de Boom en Boomitem besturingselementen.

• Wanneer het ExpandCollapseState besturingselement is ingesteld op LeafNode, is elke ExpandCollapsePattern functionaliteit momenteel inactief voor het besturingselement en is de enige informatie die kan worden verkregen met behulp van dit besturingspatroon de ExpandCollapseState. Als er vervolgens sub-objecten worden toegevoegd, verandert ExpandCollapseState en wordt ExpandCollapsePattern functionaliteit geactiveerd.

• ExpandCollapseState verwijst alleen naar de zichtbaarheid van directe onderliggende objecten; het verwijst niet naar de zichtbaarheid van alle afstammende objecten.

• De functionaliteit uitvouwen en samenvouwen is controlespecifiek. Hier volgen enkele voorbeelden van dit gedrag.

  • Het persoonlijke Office-menu kan een menuitem met drie statussen (ExpandedCollapsedenPartiallyExpanded) zijn waarbij het besturingselement de status aangeeft die moet worden aangenomen wanneer een Expand of Collapse wordt aangeroepen.

  • Als u een TreeItem Expand aanroept, worden alle afstammelingen of alleen directe kinderen weergegeven.

  • Als het aanroepen van Expand of Collapse op een besturingselement de status van de onderliggende exemplaren behoudt, moet een wijzigingsgebeurtenis voor zichtbaarheid worden verzonden, niet een statuswijzigingsgebeurtenis. Als het bovenliggende besturingselement de status van de onderliggende exemplaren niet behoudt wanneer het samengevouwen is, kan het besturingselement alle nakomelingen vernietigen die niet meer zichtbaar zijn en een vernietigde gebeurtenis genereren; of het kan de ExpandCollapseState status van elke afstammeling wijzigen en een wijzigingsgebeurtenis voor zichtbaarheid verzenden.

• Om navigatie te garanderen, is het wenselijk dat een object zich in de UI Automation-structuur bevindt (met de juiste zichtbaarheidsstatus), ongeacht de bovenliggende elementen ExpandCollapseState. Als afstammelingen op aanvraag worden gegenereerd, worden ze mogelijk alleen weergegeven in de UI Automation-structuur nadat ze voor het eerst of alleen zichtbaar zijn.

Vereiste leden voor IExpandCollapseProvider

De volgende eigenschappen en methoden zijn vereist voor de implementatie IExpandCollapseProvider.

Vereiste leden	Ledentype	Opmerkingen
ExpandCollapseState	Vastgoed	Geen
Expand	Methode	Geen
Collapse	Methode	Geen
AutomationPropertyChangedEventHandler	Gebeurtenis	Dit besturingselement heeft geen gekoppelde gebeurtenissen; gebruik deze algemene gemachtigde.

Uitzonderingen

Providers moeten de volgende uitzonderingen genereren.

Uitzonderingstype	Conditie
InvalidOperationException	Of Expand of Collapse wordt aangeroepen wanneer de ExpandCollapseState = LeafNode.

Zie ook

• Overzicht van UI-automatiseringsbesturingspatronen
• Ondersteuning van bedieningspatronen in een UI Automation Provider
• UI Automation-besturingspatronen voor clients
• Navigeren tussen ui-automatiseringselementen met TreeWalker
• Overzicht van de UI Automation Tree
• Caching gebruiken in de UI-automatisering van de gebruikersinterface