Selectiebeheerpatroon
Beschrijft richtlijnen en conventies voor het implementeren van ISelectionProvider, inclusief informatie over eigenschappen, methoden en gebeurtenissen. Het selectiepatroon wordt gebruikt ter ondersteuning van besturingselementen die fungeren als containers voor een verzameling selecteerbare onderliggende items. De onderliggende elementen van dit element moeten ISelectionItemProviderimplementeren.
Zie Besturingstypen en de ondersteunde besturingspatronenvoor voorbeelden van besturingselementen die dit besturingspatroon implementeren.
Dit onderwerp bevat de volgende secties.
- richtlijnen en conventies voor de tenuitvoerlegging
- Vereiste leden voor ISelectionProvider-
- Verwante onderwerpen
Implementatierichtlijnen en conventies
Let bij het implementeren van het selectiepatroon controlepatroon op de volgende richtlijnen en conventies:
Besturingselementen voor het implementeren van ISelectionProvider toestaan dat één of meerdere onderliggende items worden geselecteerd. Keuzelijsten, lijstweergaven en structuurweergaven ondersteunen bijvoorbeeld meerdere selecties, terwijl keuzelijsten, schuifregelaars en keuzerondjes één selectie ondersteunen.
Besturingselementen met een minimum, maximum en doorlopend bereik, zoals de schuifregelaar Volume van een mediaspeler, moeten IRangeValueProvider- implementeren in plaats van ISelectionProvider.
Besturingselementen met één selectie waarmee onderliggende besturingselementen worden beheerd die IRawElementProviderFragmentRoot-implementeren, zoals de schuifregelaar schermresolutie in het dialoogvenster Weergave-eigenschappen voor Windows, of het kleurenkiezer selectiebesturingselement van Microsoft Word (zie de volgende afbeelding), moet ISelectionProviderimplementeren; hun kinderen moeten zowel IRawElementProviderFragment als ISelectionItemProviderimplementeren.
Menu's bieden geen ondersteuning voor het selectie--besturingspatroon. Als u werkt met menu-items met zowel afbeeldingen als tekst (zoals het voorbeeldvenster items in het menu Weergave in Microsoft Outlook) en de status moet overbrengen, moet u IToggleProviderimplementeren.
Vereiste leden voor ISelectionProvider
De volgende eigenschappen, methoden en gebeurtenissen zijn vereist voor het implementeren van de ISelectionProvider interface.
| Vereiste leden | Type lid | Notities |
|---|---|---|
| CanSelectMultiple- | Eigenschap | Geen |
| IsSelectionRequired | Eigenschap | Geen |
| GetSelection- | Methode | Geen |
| UIA_Selection_InvalidatedEventId | Gebeurtenis | Deze gebeurtenis genereren wanneer een selectie in een container aanzienlijk is gewijzigd. |
De ISelectionProvider::IsSelectionRequired en CanSelectMultiple eigenschappen kunnen dynamisch zijn. De initiële status van een besturingselement bevat bijvoorbeeld mogelijk geen items die standaard zijn geselecteerd, wat aangeeft dat IsSelectionRequired onwaar is. Nadat een item is geselecteerd, moet het besturingselement echter altijd ten minste één item hebben geselecteerd. In zeldzame gevallen kan een besturingselement ook toestaan dat meerdere items worden geselecteerd tijdens de initialisatie, maar dat er vervolgens slechts enkele selecties kunnen worden gemaakt.
Verwante onderwerpen
-
Overzicht van UI Automation-besturingspatronen
-
Overzicht van UI Automation Tree