Package at.bestsolution.uia

Interface IInvokeProvider

All Superinterfaces:
IInitable
public interface IInvokeProvider extends IInitable
Provides access to controls that initiate or perform a single, unambiguous action and do not maintain state when activated.

Implemented on a Microsoft UI Automation provider that must support the Invoke control pattern.

Controls implement IInvokeProvider if the same behavior is not exposed through another control pattern provider. For example, if the Invoke method of a control performs the same action as the IExpandCollapseProvider::Expand or Collapse method, the control should not also implement IInvokeProvider.

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static class 
    IInvokeProvider.InvokeProviderContext
    context object for IInvokeProvider

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    Invoke()
    Sends a request to activate a control and initiate its single, unambiguous action.

    Methods inherited from interface at.bestsolution.uia.IInitable

    initialize

  • Method Details

    • Invoke

      void Invoke()
      Sends a request to activate a control and initiate its single, unambiguous action.

      IInvokeProvider::Invoke is an asynchronous call and must return immediately without blocking.

      Note This is particularly critical for controls that, directly or indirectly, launch a modal dialog when invoked. Any Microsoft UI Automation client that instigated the event will remain blocked until the modal dialog is closed.

      IInvokeProvider::Invoke raises the Invoked event after the control has completed its associated action, if possible.

      The event should be raised before servicing the Invoke request in the following scenarios:

      • It is not possible or practical to wait until the action is complete.
      • The action requires user interaction.
      • The action is time-consuming and will cause the calling client to block for a significant length of time.