Macro CreateWindowA (winuser.h)

Crea una ventana superpuesta, emergente o secundaria. Especifica la clase de ventana, el título de la ventana, el estilo de ventana y (opcionalmente) la posición inicial y el tamaño de la ventana. La función también especifica el propietario o primario de la ventana, si existe, y el menú de la ventana.

Para usar estilos de ventana extendidos además de los estilos admitidos por CreateWindow, use la función CreateWindowEx.

Sintaxis

HWND CreateWindowA(
  [in, optional] LPCSTR    lpClassName,
  [in, optional] LPCSTR    lpWindowName,
  [in]           DWORD     dwStyle,
  [in]           int       x,
  [in]           int       y,
  [in]           int       nWidth,
  [in]           int       nHeight,
  [in, optional] HWND      hWndParent,
  [in, optional] HMENU     hMenu,
  [in, optional] HINSTANCE hInstance,
  [in, optional] LPVOID    lpParam
);

Parámetros

[in, optional] lpClassName

Tipo: LPCSTR de

Cadenaterminada en un null o un átomo de clase creado por una llamada anterior a la función RegisterClass o RegisterClassEx. El átomo debe estar en la palabra de orden bajo de lpClassName; la palabra de orden superior debe ser cero. Si lpClassName es una cadena, especifica el nombre de la clase de ventana. El nombre de clase puede ser cualquier nombre registrado con RegisterClass o RegisterClassEx, siempre que el módulo que registra la clase también sea el módulo que crea la ventana. El nombre de clase también puede ser cualquiera de los nombres de clase del sistema predefinidos. Para obtener una lista de nombres de clase del sistema, vea la sección Comentarios.

[in, optional] lpWindowName

Tipo: LPCSTR de

Nombre de la ventana. Si el estilo de ventana especifica una barra de título, el título de la ventana al que apunta lpWindowName se muestra en la barra de título. Al usar createWindow para crear controles, como botones, casillas y controles estáticos, use lpWindowName para especificar el texto del control. Al crear un control estático con el estilo de SS_ICON, use lpWindowName para especificar el nombre o identificador del icono. Para especificar un identificador, use la sintaxis "#num".

[in] dwStyle

Tipo: DWORD de

Estilo de la ventana que se va a crear. Este parámetro puede ser una combinación de los valores de estilo de ventana , además de los estilos de control indicados en la sección Comentarios.

[in] x

Tipo: int

Posición horizontal inicial de la ventana. Para una ventana emergente o superpuesta, el parámetro x es la coordenada x inicial de la esquina superior izquierda de la ventana, en coordenadas de pantalla. Para una ventana secundaria, x es la coordenada x de la esquina superior izquierda de la ventana en relación con la esquina superior izquierda del área cliente de la ventana primaria. Si este parámetro se establece en CW_USEDEFAULT, el sistema selecciona la posición predeterminada para la esquina superior izquierda de la ventana y omite el parámetro y. CW_USEDEFAULT solo es válido para ventanas superpuestas; Si se especifica para una ventana emergente o secundaria, los parámetros x y y se establecen en cero.

[in] y

Tipo: int

Posición vertical inicial de la ventana. Para una ventana emergente o superpuesta, el parámetro y es la coordenada y inicial de la esquina superior izquierda de la ventana, en coordenadas de pantalla. Para una ventana secundaria, y es la coordenada y inicial de la esquina superior izquierda de la ventana secundaria en relación con la esquina superior izquierda del área cliente de la ventana primaria. Para un cuadro de lista, y es la coordenada y inicial de la esquina superior izquierda del área cliente del cuadro de lista en relación con la esquina superior izquierda del área cliente de la ventana primaria.

Si se crea una ventana superpuesta con el conjunto de bits de estilo WS_VISIBLE y el parámetro x se establece en CW_USEDEFAULT, el parámetro y determina cómo se muestra la ventana. Si el parámetro y es CW_USEDEFAULT, el administrador de ventanas llama a ShowWindow con la marca SW_SHOW después de crear la ventana. Si el parámetro y es otro valor, el administrador de ventanas llama a showWindow con ese valor como el parámetro nCmdShow .

[in] nWidth

Tipo: int

Ancho, en unidades de dispositivo, de la ventana. En el caso de las ventanas superpuestas, nWidth es el ancho de la ventana, en coordenadas de pantalla o CW_USEDEFAULT. Si nWidth es CW_USEDEFAULT, el sistema selecciona un ancho y alto predeterminados para la ventana; el ancho predeterminado se extiende desde la coordenada x inicial hasta el borde derecho de la pantalla y el alto predeterminado se extiende desde la coordenada Y inicial hasta la parte superior del área de icono. CW_USEDEFAULT solo es válido para ventanas superpuestas; Si se especifica CW_USEDEFAULT para una ventana emergente o secundaria, nWidth y nHeight se establecen en cero.

[in] nHeight

Tipo: int

Alto, en unidades de dispositivo, de la ventana. En el caso de las ventanas superpuestas, nHeight es el alto de la ventana, en coordenadas de pantalla. Si nWidth se establece en CW_USEDEFAULT, el sistema omite nHeight.

[in, optional] hWndParent

Tipo: HWND

Identificador de la ventana primaria o propietaria de la ventana que se va a crear. Para crear una ventana secundaria o una ventana de propiedad, proporcione un identificador de ventana válido. Este parámetro es opcional para las ventanas emergentes.

Para crear una ventana de solo mensaje , proporcione HWND_MESSAGE o un identificador a una ventana de solo mensaje existente.

[in, optional] hMenu

Tipo: HMENU de

Identificador de un menú o especifica un identificador de ventana secundaria en función del estilo de la ventana. Para una ventana emergente o superpuesta, hMenu identifica el menú que se va a usar con la ventana; puede ser NULL si se va a usar el menú de clase. Para una ventana secundaria, hMenu especifica el identificador de ventana secundaria, un valor entero usado por un control de cuadro de diálogo para notificar a su elemento primario los eventos. La aplicación determina el identificador de ventana secundaria; debe ser único para todas las ventanas secundarias con la misma ventana primaria.

[in, optional] hInstance

Tipo: HINSTANCE

Identificador de la instancia del módulo que se va a asociar a la ventana.

[in, optional] lpParam

Tipo: LPVOID de

Puntero a un valor que se va a pasar a la ventana a través de la estructura CREATESTRUCT (miembro lpCreateParams) al que apunta el lParam parámetro del mensaje de WM_CREATE. Esta función envía este mensaje a la ventana creada antes de que se devuelva.

Si una aplicación llama a CreateWindow para crear una ventana de cliente MDI, lpParam debe apuntar a una estructura CLIENTCREATESTRUCT. Si una ventana de cliente MDI llama a CreateWindow para crear una ventana secundaria de MDI, lpParam debe apuntar a una estructura MDICREATESTRUCT . lpParam puede ser NULL si no se necesita ningún dato adicional.

Valor devuelto

Tipo: HWND

Si la función se ejecuta correctamente, el valor devuelto es un identificador de la nueva ventana.

Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Antes de devolverlo, CreateWindow envía un mensaje WM_CREATE al procedimiento de ventana. Para ventanas secundarias, emergentes y superpuestas, CreateWindow envía WM_CREATE, WM_GETMINMAXINFOy WM_NCCREATE mensajes a la ventana. El parámetro lParam del mensaje de WM_CREATE contiene un puntero a una estructura CREATESTRUCT . Si se especifica el estilo de WS_VISIBLE, createWindow envía la ventana todos los mensajes necesarios para activar y mostrar la ventana.

Si la ventana creada es una ventana secundaria, su posición predeterminada está en la parte inferior del orden Z. Si la ventana creada es una ventana de nivel superior, su posición predeterminada está en la parte superior del orden Z (pero debajo de todas las ventanas de nivel superior a menos que la ventana creada esté más arriba).

Para obtener información sobre cómo controlar si la barra de tareas muestra un botón para la ventana creada, vea Administrar botones de la barra de tareas.

Para obtener información sobre cómo quitar una ventana, consulte la función DestroyWindow.

Las siguientes clases de sistema predefinidas se pueden especificar en el parámetro lpClassName. Tenga en cuenta los estilos de control correspondientes que puede usar en el parámetro dwStyle.

createWindow se implementa como una llamada a la función de CreateWindowEx, como se muestra a continuación.

#define CreateWindowA(lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)\
CreateWindowExA(0L, lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)

#define CreateWindowW(lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)\
CreateWindowExW(0L, lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)

#ifdef UNICODE
#define CreateWindow  CreateWindowW
#else
#define CreateWindow  CreateWindowA
#endif

Ejemplos

Para obtener un ejemplo, vea Uso de clases de ventana.

Requisitos

Consulte también

Acerca de la interfaz de varios documentos

clases de ventana de control común

conceptual de

createWindowEx

DestroyWindow

EnableWindow

otros recursos

de referencia de

registerClass

RegisterClassEx

showWindow

WM_COMMAND

WM_CREATE

WM_GETMINMAXINFO

WM_NCCREATE

WM_PAINT

Windows