Estructura CREATESTRUCTA (winuser.h)

Artículo
11/20/2024

Define los parámetros de inicialización pasados al procedimiento de ventana de una aplicación. Estos miembros son idénticos a los parámetros de la función de CreateWindowEx.

Sintaxis

typedef struct tagCREATESTRUCTA {
  LPVOID    lpCreateParams;
  HINSTANCE hInstance;
  HMENU     hMenu;
  HWND      hwndParent;
  int       cy;
  int       cx;
  int       y;
  int       x;
  LONG      style;
  LPCSTR    lpszName;
  LPCSTR    lpszClass;
  DWORD     dwExStyle;
} CREATESTRUCTA, *LPCREATESTRUCTA;

Miembros

lpCreateParams

Tipo: LPVOID de

Contiene datos adicionales que se pueden usar para crear la ventana. Si la ventana se crea como resultado de una llamada al CreateWindow o función CreateWindowEx, este miembro contiene el valor del parámetro lpParam especificado en la llamada de función.

Si la ventana que se crea es una ventana de cliente MDI, este miembro contiene un puntero a una estructura CLIENTCREATESTRUCT. Si la ventana que se crea es una ventana secundaria de MDI, este miembro contiene un puntero a una estructura MDICREATESTRUCT.

Si la ventana se crea a partir de una plantilla de diálogo, este miembro es la dirección de un valor short que especifica el tamaño, en bytes, de los datos de creación de la ventana. El valor va seguido inmediatamente de los datos de creación. Para obtener más información, vea la siguiente sección Comentarios.

hInstance

Tipo: HINSTANCE

Identificador del módulo que posee la nueva ventana.

hMenu

Tipo: HMENU de

Identificador del menú que va a usar la nueva ventana.

hwndParent

Tipo: HWND

Identificador de la ventana primaria, si la ventana es una ventana secundaria. Si la ventana es propiedad, este miembro identifica la ventana del propietario. Si la ventana no es una ventana secundaria o propiedad, este miembro es NULL.

cy

Tipo: int

Alto de la nueva ventana, en píxeles.

cx

Tipo: int

Ancho de la nueva ventana, en píxeles.

y

Tipo: int

Coordenada y de la esquina superior izquierda de la nueva ventana. Si la nueva ventana es una ventana secundaria, las coordenadas son relativas a la ventana primaria. De lo contrario, las coordenadas son relativas al origen de la pantalla.

x

Tipo: int

Coordenada x de la esquina superior izquierda de la nueva ventana. Si la nueva ventana es una ventana secundaria, las coordenadas son relativas a la ventana primaria. De lo contrario, las coordenadas son relativas al origen de la pantalla.

style

Tipo: LONG

Estilo de la nueva ventana. Para obtener una lista de los valores posibles, consulte Estilos de ventana.

lpszName

Tipo: LPCTSTR de

Nombre de la nueva ventana.

lpszClass

Tipo: LPCTSTR de

Puntero a una cadena terminada en null o un átomo que especifica el nombre de clase de la nueva ventana.

dwExStyle

Tipo: DWORD de

Estilo de ventana extendida para la nueva ventana. Para obtener una lista de los valores posibles, vea estilos de ventana extendidos.

Observaciones

Dado que el miembro lpszClass puede contener un puntero a un átomo local (y, por tanto, inaccesible), no obtenga el nombre de clase mediante este miembro. En su lugar, use la función GetClassName .

Debe acceder a los datos representados por el lpCreateParams miembro mediante un puntero que se ha declarado mediante el tipo UNALIGNED, ya que es posible que el puntero no esté DWORD alineado. Esto se muestra en el ejemplo siguiente:

typedef struct tagMyData 
{
    // Define creation data here. 
} MYDATA; 
 
typedef struct tagMyDlgData 
{ 
    SHORT   cbExtra; 
    MYDATA  myData; 
} MYDLGDATA, UNALIGNED *PMYDLGDATA; 
 
PMYDLGDATA pMyDlgdata = (PMYDLGDATA) (((LPCREATESTRUCT) lParam)->lpCreateParams);

Nota

El encabezado winuser.h define CREATESTRUCT como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	winuser.h (incluya Windows.h)