função WindowPattern_WaitForInputIdle (uiautomationcoreapi.h)

  • Artigo
Nota Essa função foi preterida. Em vez disso, os aplicativos cliente devem usar as interfaces COM (Modelo de Objeto de Componente) do Microsoft Automação da Interface do Usuário.
 
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 WindowPattern_WaitForInputIdle(
  [in]  HUIAPATTERNOBJECT hobj,
  [in]  int               milliseconds,
  [out] BOOL              *pResult
);

Parâmetros

[in] hobj

Tipo: HUIAPATTERNOBJECT

O objeto padrão de controle.

[in] milliseconds

Tipo: int

O número de milissegundos a aguardar antes de recuperar o pResult.

[out] pResult

Tipo: BOOL*

TRUE se a janela estiver pronta para aceitar a entrada do usuário; caso contrário , FALSE.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário.

Comentários

Esse método normalmente é usado em conjunto com o tratamento de um WindowOpenedEvent (Window_WindowOpened_Event_GUID). 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 pResult 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 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationcoreapi.h
Biblioteca Uiautomationcore.lib
DLL Uiautomationcore.dll