Compartir a través de


Función GetParent (winuser.h)

Recupera un identificador para el propietario o primario de la ventana especificada.

Para recuperar un identificador de un antecesor especificado, use la función GetAncestor .

Sintaxis

HWND GetParent(
  [in] HWND hWnd
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana cuyo identificador de ventana principal se va a recuperar.

Valor devuelto

Tipo: HWND

Si la ventana es una ventana secundaria, el valor devuelto es un identificador de la ventana primaria. Si la ventana es una ventana de nivel superior con el estilo WS_POPUP , el valor devuelto es un identificador de la ventana del propietario.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Normalmente, se produce un error en esta función por uno de los siguientes motivos:

  • La ventana es una ventana de nivel superior que no está o no tiene el estilo WS_POPUP .
  • La ventana del propietario tiene WS_POPUP estilo.

Comentarios

Para obtener la ventana de propietario de una ventana, en lugar de usar GetParent, use GetWindow con la marca GW_OWNER . Para obtener la ventana primaria y no el propietario, en lugar de usar GetParent, use GetAncestor con la marca GA_PARENT .

Ejemplos

Para obtener un ejemplo, vea Inicializar un cuadro de diálogo.

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

GetAncestor

GetWindow

Referencia

SetParent

Windows

Estilos de Windows