Compartir a través de

Función GetWindow (winuser.h)

  • Artículo

Recupera un identificador de una ventana que tiene la relación especificada (orden Z o propietario) con la ventana especificada.

Sintaxis

HWND GetWindow(
  [in] HWND hWnd,
  [in] UINT uCmd
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador a una ventana. El identificador de ventana recuperado es relativo a esta ventana, en función del valor del parámetro uCmd .

[in] uCmd

Tipo: UINT

Relación entre la ventana especificada y la ventana cuyo identificador se va a recuperar. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
GW_CHILD
5
 El identificador recuperado identifica la ventana secundaria en la parte superior del orden Z, si la ventana especificada es una ventana primaria; de lo contrario, el identificador recuperado es NULL. La función examina solo las ventanas secundarias de la ventana especificada. No examina las ventanas descendientes.
GW_ENABLEDPOPUP
6
 El identificador recuperado identifica la ventana emergente habilitada que pertenece a la ventana especificada (la búsqueda usa la primera ventana que se encuentra mediante GW_HWNDNEXT); de lo contrario, si no hay ventanas emergentes habilitadas, el identificador recuperado es el de la ventana especificada.
GW_HWNDFIRST
0
 El identificador recuperado identifica la ventana del mismo tipo que es más alto en el orden Z.

Si la ventana especificada es una ventana superior, el identificador identifica una ventana superior. Si la ventana especificada es una ventana de nivel superior, el identificador identifica una ventana de nivel superior. Si la ventana especificada es una ventana secundaria, el identificador identifica una ventana del mismo nivel.
GW_HWNDLAST
1
 El identificador recuperado identifica la ventana del mismo tipo que es menor en el orden Z.

Si la ventana especificada es una ventana superior, el identificador identifica una ventana superior. Si la ventana especificada es una ventana de nivel superior, el identificador identifica una ventana de nivel superior. Si la ventana especificada es una ventana secundaria, el identificador identifica una ventana del mismo nivel.
GW_HWNDNEXT
2
 El identificador recuperado identifica la ventana debajo de la ventana especificada en el orden Z.

Si la ventana especificada es una ventana superior, el identificador identifica una ventana superior. Si la ventana especificada es una ventana de nivel superior, el identificador identifica una ventana de nivel superior. Si la ventana especificada es una ventana secundaria, el identificador identifica una ventana del mismo nivel.
GW_HWNDPREV
3
 El identificador recuperado identifica la ventana situada encima de la ventana especificada en el orden Z.

Si la ventana especificada es una ventana superior, el identificador identifica una ventana superior. Si la ventana especificada es una ventana de nivel superior, el identificador identifica una ventana de nivel superior. Si la ventana especificada es una ventana secundaria, el identificador identifica una ventana del mismo nivel.
GW_OWNER
4
 El identificador recuperado identifica la ventana de propietario de la ventana especificada, si existe. Para obtener más información, consulte Propiedad de Windows.

Valor devuelto

Tipo: HWND

Si la función se ejecuta correctamente, el valor devuelto es un identificador de ventana. Si no existe ninguna ventana con la relación especificada con la ventana especificada, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función EnumChildWindows es más confiable que llamar a GetWindow en un bucle. Una aplicación que llama a GetWindow para realizar esta tarea corre el riesgo de detectarse en un bucle infinito o hacer referencia a un identificador a una ventana que se ha destruido.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-window-l1-1-0 (introducido en Windows 8)

Consulte también

Conceptual

EnumChildWindows

Referencia

Windows