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

Hace que el código de llamada se bloquee durante el tiempo especificado o hasta que el proceso asociado entre en un estado de inactividad, lo que ocurra primero.

Sintaxis

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

Parámetros

[in] milliseconds

Tipo: int

Cantidad de tiempo, en milisegundos, que se esperará hasta que el proceso asociado entre a un estado de inactividad. El máximo es Int32.MaxValue.

[out, retval] pRetVal

Tipo: BOOL*

Recibe TRUE si la ventana ha entrado en estado inactivo; FALSE si se agota el tiempo de espera. Este parámetro se pasa sin inicializar.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método se usa normalmente junto con el control de un UIA_Window_WindowOpenedEventId. La implementación depende del marco de aplicación subyacente; por lo tanto, este método puede devolver algún tiempo después de que la ventana esté lista para la entrada del usuario. El código de llamada no debe basarse en este método para determinar exactamente cuándo la ventana está inactiva. Use el valor de pRetVal para determinar si la ventana está lista para la entrada o si el método agota el tiempo de espera.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado uiautomationcore.h (incluir UIAutomation.h)

Consulte también

IWindowProvider

Información general sobre proveedores de UI Automation