IInvokeProvider.Invoke Método

Definición

Espacio de nombres:

System.Windows.Automation.Provider

Ensamblado:

UIAutomationProvider.dll

Envía una solicitud para activar un control e iniciar su acción única e inequívoca.

public:
 void Invoke();

public void Invoke ();

abstract member Invoke : unit -> unit

Public Sub Invoke ()

Excepciones

ElementNotEnabledException

Si el control no está habilitado.

Ejemplos

En el ejemplo siguiente se implementa el Invoke método en el controlador de eventos MouseDown de un control . Supongamos que providerControl es una variable miembro que se inicializó cuando se construyó la clase .

/// <summary>
/// Responds to an InvokePattern.Invoke by simulating a MouseDown event.
/// </summary>
/// <remarks>
/// ProviderControl is a button control object that also implements 
/// IRawElementProviderSimple.
/// </remarks>
void IInvokeProvider.Invoke()
{
    // If the control is not enabled, we're responsible for letting UIAutomation know.
    // It catches the exception and then throws it to the client.
    if (false == (bool)rawElementProvider.GetPropertyValue(AutomationElementIdentifiers.IsEnabledProperty.Id))
    {
        throw new ElementNotEnabledException();
    }

    // Create arguments for the event. The parameters aren't used.
    MouseEventArgs mouseArgs = new MouseEventArgs(MouseButtons.Left, 1, 0, 0, 0);

    // Invoke the MouseDown handler. We cannot call MyControl_MouseDown directly, 
    // because it is illegal to update the UI from a different thread.
    MouseEventHandler onMouseEvent = ProviderControl.RootButtonControl_MouseDown;
    ProviderControl.BeginInvoke(onMouseEvent, new object[] { this, mouseArgs });
    }
}

Comentarios

Invoke es una llamada asincrónica y debe volver inmediatamente sin bloquearse.

Nota

Este comportamiento es especialmente importante para los controles que, directa o indirectamente, inician un cuadro de diálogo modal cuando se invocan. Cualquier cliente de Automatización de la interfaz de usuario que haya provocado que el evento permanezca bloqueado hasta que se cierre el cuadro de diálogo modal.

Invoke genera el evento InvokedEvent. Si es posible, el evento debe generarse después de que el control haya completado su acción asociada.

InvokedEvent debe generarse antes de atender la Invoke solicitud en los escenarios siguientes:

• No es posible ni práctico esperar hasta que se complete la acción.

• La acción requiere la interacción del usuario.

• La acción consume mucho tiempo y hará que el cliente que realiza la llamada se bloquee durante un período de tiempo significativo.

Consulte también

• Implementar el patrón de control Invoke de UI Automation