Besturingselementpatroon aanroepen
Beschrijft richtlijnen en conventies voor het implementeren van IInvokeProvider, inclusief informatie over methoden. Het Aanroepen controlepatroon wordt gebruikt ter ondersteuning van besturingselementen die de status niet behouden wanneer deze worden geactiveerd, maar in plaats daarvan een enkele, ondubbelzinnige actie starten of uitvoeren.
Besturingselementen die wel de status behouden, zoals selectievakjes en keuzerondjes, moeten in plaats daarvan respectievelijk IToggleProvider implementeren en ISelectionProvider. 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 IInvokeProvider-
- Verwante onderwerpen
Implementatierichtlijnen en conventies
Let op de volgende richtlijnen en conventies bij het implementeren van het controlepatroon aanroepen:
Besturingselementen implementeren IInvokeProvider als hetzelfde gedrag niet beschikbaar is via een andere provider voor besturingspatronen. Als de methode IUIAutomationInvokePattern::Invoke op een besturingselement dezelfde actie uitvoert als de methode IUIAutomationExpandCollapsePattern::Expand of Collapse methode, moet het besturingselement IInvokeProvider niet implementeren.
Het aanroepen van een besturingselement wordt over het algemeen uitgevoerd door op Enter te klikken of erop te dubbelklikken of te dubbelklikken, een vooraf gedefinieerde sneltoets of een andere combinatie van toetsaanslagen.
De gebeurtenis Aangeroepen (UIA_Invoke_InvokedEventId) wordt gegenereerd op een besturingselement dat is geactiveerd (als reactie op een besturingselement dat de bijbehorende actie uitvoert). Indien mogelijk moet de gebeurtenis worden gegenereerd nadat het besturingselement de actie heeft voltooid en zonder blokkering wordt geretourneerd. De aangeroepen gebeurtenis (UIA_Invoke_InvokedEventId) moet worden gegenereerd voordat de -aanvraag wordt aangeroepen in de volgende scenario's:
- Het is niet mogelijk of praktisch om te wachten totdat de actie is voltooid.
- Voor de actie is gebruikersinteractie vereist.
- De actie is tijdrovend en zorgt ervoor dat de aanroepende client gedurende een aanzienlijke hoeveelheid tijd wordt geblokkeerd.
Als het aanroepen van het besturingselement aanzienlijke bijwerkingen heeft, moeten deze bijwerkingen worden weergegeven via de eigenschap HelpText. Zelfs als IUIAutomationInvokePattern::Invoke niet is gekoppeld aan de selectie, kan Aanroepen ertoe leiden dat een ander besturingselement wordt geselecteerd.
Aanwijzen (of muisaanwijzer)-effecten vormen over het algemeen geen Aangeroepen gebeurtenis. Besturingselementen die echter een actie uitvoeren (in plaats van een visueel effect te veroorzaken) op basis van de muisaanwijzerstatus, moeten ondersteuning bieden voor het Aanroepen besturingspatroon.
Notitie
Deze implementatie wordt beschouwd als een toegankelijkheidsprobleem als het besturingselement alleen kan worden aangeroepen als gevolg van een muisgerelateerd neveneffect.
Het aanroepen van een besturingselement verschilt van het selecteren van een item. Afhankelijk van het besturingselement kan het aanroepen echter ertoe leiden dat het item als neveneffect wordt geselecteerd. Als u bijvoorbeeld een microsoft Word-documentlijstitem aanroept in de map Mijn documenten, selecteert u het item en opent u het document.
Een element kan onmiddellijk na het aanroepen uit de Microsoft UI Automation-structuur verdwijnen. Het aanvragen van gegevens van het element dat door de callback van de gebeurtenis wordt verstrekt, kan als gevolg hiervan mislukken. Het vooraf ophalen van gegevens in de cache is de aanbevolen tijdelijke oplossing.
Besturingselementen kunnen meerdere besturingspatronen implementeren. Met het besturingselement Opvulkleur op de Microsoft Excel-werkbalk worden bijvoorbeeld de besturingspatronen Aanroepen en ExpandCollapse geïmplementeerd. Het besturingspatroon ExpandCollapse toont het menu en het Aanroepen besturingspatroon vult de actieve selectie met de gekozen kleur.
Vereiste leden voor IInvokeProvider-
De volgende methode is vereist voor het implementeren van de IInvokeProvider interface.
Dit besturingselementpatroon heeft geen gekoppelde eigenschappen of gebeurtenissen.