Delen via

Het implementeren van het "UI Automation Invoke Control Pattern"

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 voor implementatie IInvokeProvidergeïntroduceerd, inclusief informatie over gebeurtenissen en eigenschappen. Koppelingen naar aanvullende verwijzingen worden aan het einde van het onderwerp weergegeven.

Het InvokePattern besturingspatroon wordt gebruikt ter ondersteuning van besturingselementen die de status niet behouden wanneer ze worden geactiveerd, maar in plaats daarvan één, ondubbelzinnige actie starten of uitvoeren. Besturingselementen die wel de status behouden, zoals selectievakjes en keuzerondjes, moeten respectievelijk IToggleProvider en ISelectionItemProvider implementeren. Voor voorbeelden van besturingselementen die het oproeppatroon implementeren, zie Beheerpatroontoewijzing voor UI Automation-clients.

Implementatierichtlijnen en conventies

Let bij het implementeren van het patroon Aanroepen op de volgende richtlijnen en conventies:

  • Besturingselementen implementeren IInvokeProvider als hetzelfde gedrag niet beschikbaar is via een andere provider voor besturingspatronen. Als de Invoke methode op een besturingselement bijvoorbeeld dezelfde actie uitvoert als de Expand of Collapse methode, hoeft het besturingselement niet IInvokeProvider te 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.

  • InvokedEvent wordt opgeroepen op een bedieningselement dat is geactiveerd (als reactie op een bedieningselement 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 moet worden gegenereerd voordat de aanroepaanvraag in de volgende scenario's wordt uitgevoerd:

    • 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 neveneffecten worden weergegeven via de HelpText eigenschap. Hoewel Invoke niet gekoppeld is aan selectie, kan Invoke ervoor zorgen 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 hover-toestand, moeten het InvokePattern besturingspatroon ondersteunen.

Opmerking

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 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 de Vulkleur-besturing op de werkbalk van Microsoft Excel worden bijvoorbeeld zowel het InvokePattern- als ExpandCollapsePattern-besturingspatroon geïmplementeerd. ExpandCollapsePattern toont het menu en de InvokePattern vult de actieve selectie met de gekozen kleur.

Vereiste leden voor IInvokeProvider

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

Vereiste leden Ledentype Opmerkingen
Invoke methode Invoke is een asynchrone aanroep en moet onmiddellijk terugkeren zonder te blokkeren.

Dit gedrag is met name essentieel voor besturingselementen die, direct of indirect, een modaal dialoogvenster starten wanneer ze worden aangeroepen. Elke UI Automation-client die de gebeurtenis heeft geïnstigeerd, blijft geblokkeerd totdat het modale dialoogvenster is gesloten.

Uitzonderingen

Providers moeten de volgende uitzonderingen genereren.

Uitzonderingstype Conditie
ElementNotEnabledException Als het besturingselement niet is ingeschakeld.

Zie ook

  • Last updated on