Het UI Automation SelectionItem-besturingselementpatroon implementeren

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 Automationvoor de meest recente informatie over UI Automation.

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

Het SelectionItemPattern-besturingspatroon wordt gebruikt ter ondersteuning van besturingselementen die fungeren als afzonderlijke, selecteerbare onderliggende items van containerbesturingselementen die ISelectionProviderimplementeren. Zie Control Pattern Mapping for UI Automation Clientsvoor voorbeelden van besturingselementen die het selectionItem-besturingspatroon implementeren.

Implementatierichtlijnen en conventies

Houd bij het implementeren van het selectie-element besturingspatroon rekening met de volgende richtlijnen en conventies:

• Enkelvoudige selectiebesturingselementen die onderliggende besturingselementen beheren die IRawElementProviderFragmentRootimplementeren, zoals de schuifregelaar schermresolutie in het dialoogvenster Weergave-eigenschappen, moeten ISelectionProvider implementeren en hun onderliggende elementen moeten zowel IRawElementProviderFragment als ISelectionItemProviderimplementeren.

Vereiste leden voor ISelectionItemProvider

De volgende eigenschappen, methoden en gebeurtenissen zijn vereist voor het implementeren van ISelectionItemProvider.

Vereiste leden	Lidtype	Notities
IsSelected	Eigendom	Geen
SelectionContainer	Eigendom	Geen
AddToSelection	Methode	Geen
RemoveFromSelection	Methode	Geen
Select	Methode	Geen
ElementSelectedEvent	Gebeurtenis	Opgetreden wanneer een selectiewijziging resulteert in één geselecteerd item.
ElementAddedToSelectionEvent	Gebeurtenis	Wordt gegenereerd wanneer een item wordt toegevoegd aan een container met meerdere selecties.
ElementRemovedFromSelectionEvent	Gebeurtenis	Wordt opgeroepen wanneer een item wordt verwijderd uit een container met meervoudige selectie.
InvalidatedEvent	Gebeurtenis	Verhoogd wanneer een selectie in een container aanzienlijk is gewijzigd en vereist dat er meer ElementSelectedEvent en ElementRemovedFromSelectionEvent gebeurtenissen worden verzonden dan de InvalidateLimit constante toestaan.

• Als een Select, AddToSelectionof RemoveFromSelection bewerking resulteert in één geselecteerd item, verhoogt u ElementSelectedEvent; als dat niet het geval is, moet u ElementAddedToSelectionEvent of ElementRemovedFromSelectionEvent indien nodig verhogen.

Uitzonderingen

Providers moeten de volgende uitzonderingen genereren.

Uitzonderingstype

Conditie

InvalidOperationException

Wanneer een van de volgende pogingen wordt uitgevoerd: - RemoveFromSelection wordt aangeroepen in een container met één selectie waarbij IsSelectionRequiredProperty = true en een element al is geselecteerd. - RemoveFromSelection wordt aangeroepen in een container met meerdere selecties, waarbij IsSelectionRequiredProperty = true en slechts één element is geselecteerd. - AddToSelection wordt aangeroepen in een container met één selectie waarbij CanSelectMultipleProperty = false en een ander element al is geselecteerd.

Zie ook

• Overzicht van UI-automatiseringsbesturingspatronen
• Ondersteuning van bedieningspatronen in een UI Automation Provider
• UI Automation-besturingspatronen voor clients
• Het patroon selectiebeheer van de gebruikersinterface implementeren
• Overzicht van UI Automation Tree
• Caching gebruiken in de UI-automatisering van de gebruikersinterface
• Voorbeeld van de Fragmentprovider-sample