Estructura CREATESTRUCTA (winuser.h)

Artículo
08/28/2023

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 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

Contiene datos adicionales que se pueden usar para crear la ventana. Si la ventana se crea como resultado de una llamada a la función CreateWindow o 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 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 sección Comentarios que se muestra más adelante.

hInstance

Tipo: HINSTANCE

Identificador del módulo que posee la nueva ventana.

hMenu

Tipo: HMENU

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 de 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, vea Estilos de ventana.

lpszName

Tipo: LPCTSTR

Nombre de la nueva ventana.

lpszClass

Tipo: LPCTSTR

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

dwExStyle

Tipo: DWORD

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 tener acceso a los datos representados por el miembro lpCreateParams mediante un puntero declarado mediante el tipo UNALIGNED , ya que es posible que el puntero no esté alineado con DWORD . 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 un 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	winuser.h (incluya Windows.h)