Función GetWindow (winuser.h)
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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
Referencia