Compartilhar via

Método IInvokeProvider::Invoke (uiautomationcore.h)

  • Artigo

Envia uma solicitação para ativar um controle e iniciar sua ação única não ambígua.

Sintaxe

HRESULT Invoke();

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

IInvokeProvider::Invoke é uma chamada assíncrona e deve retornar imediatamente sem bloqueio.

Nota Isso é particularmente crítico para controles que, direta ou indiretamente, iniciam uma caixa de diálogo modal quando invocado. Qualquer cliente de Automação da Interface do Usuário da Microsoft que instigou o evento permanecerá bloqueado até que a caixa de diálogo modal seja fechada.
 
IInvokeProvider::Invoke aciona o evento Invoked depois que o controle conclui sua ação associada, se possível.

O evento deve ser gerado antes de atender à solicitação Invoke nos seguintes cenários:

  • Não é possível ou prático aguardar até que a ação seja concluída.
  • A ação requer interação do usuário.
  • A ação é demorada e fará com que o cliente de chamada seja bloqueado por um período significativo de tempo.

Requisitos

   
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho uiautomationcore.h (include UIAutomation.h)
DLL Uiautomationcore.dll

Confira também

IInvokeProvider

Visão Geral dos Provedores de Automação de Interface do Usuário