Método IWindowProvider::WaitForInputIdle (uiautomationcore.h)

  • Artigo

Faz com que o código de chamada bloqueie pelo tempo especificado ou até que o processo associado entre em um estado ocioso, aquele que for concluído primeiro.

Sintaxe

HRESULT WaitForInputIdle(
  [in]          int  milliseconds,
  [out, retval] BOOL *pRetVal
);

Parâmetros

[in] milliseconds

Tipo: int

O período de tempo, em milissegundos, para esperar que o processo associado fique ocioso. O máximo é Int32.MaxValue.

[out, retval] pRetVal

Tipo: BOOL*

Receberá TRUE se a janela tiver inserido o estado ocioso; FALSE se o tempo limite ocorreu. Este parâmetro é passado não inicializado.

Retornar valor

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

Esse método normalmente é usado em conjunto com o tratamento de um UIA_Window_WindowOpenedEventId. A implementação depende da estrutura de aplicativo subjacente; portanto, esse método pode retornar algum tempo depois que a janela estiver pronta para entrada do usuário. O código de chamada não deve depender desse método para verificar exatamente quando a janela ficou ociosa. Use o valor de pRetVal para determinar se a janela está pronta para entrada ou se o método atingiu o tempo limite.

Requisitos

Requisito Valor
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 (inclua UIAutomation.h)

Confira também

IWindowProvider

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