Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
CREATESTRUCT (1.2)
◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
#define INCL_WINWINDOWMGR
typedef struct _CREATESTRUCT { /* crst */
PVOID pPresParams;
PVOID pCtlData;
USHORT id;
HWND hwndInsertBehind;
HWND hwndOwner;
SHORT cy;
SHORT cx;
SHORT y;
SHORT x;
ULONG flStyle;
PSZ pszText;
PSZ pszClass;
HWND hwndParent;
} CREATESTRUCT;
The CREATESTRUCT structure contains information about a created window. It
is passed as the second parameter of the WM_CREATE message. Note that the
fields are identical to the parameters in the WinCreateWindow function.
Field Description
────────────────────────────────────────────────────────────────────────────
pPresParams Points to the presentation parameters. This field is
currently reserved.
pCtlData Points to the buffer that contains class-specific
information.
id Specifies the window identifier, the value given by the
application allowing a specific child window to be
identified. For example, the controls of a dialog box have
unique identifiers so that an owner window can distinguish
which control has notified it. Window identifiers are also
used for frame windows.
hwndInsertBehind Identifies the sibling window behind which the specified
window is placed. If this value is HWND_TOP, the specified
window is placed on top of all its sibling windows. If
this value is HWND_BOTTOM, the specified window is placed
behind all its sibling windows. If this value is not
HWND_TOP or HWND_BOTTOM, or if it is a child window of the
desktop window identified by the hwndOwner field, then
NULL is returned.
hwndOwner Identifies the owner window.
cy Specifies the window depth (in pels).
cx Specifies the window width (in pels).
y Specifies the vertical position of the window relative to
the origin of the parent window.
x Specifies the horizontal position of the window relative
to the origin of the parent window.
flStyle Specifies the window style. For a list of values that can
be used for this parameter, see the ◄Window styles►
topic.
pszText Points to window text or other class-specific data. The
actual structure of the data is class-specific. This data
is usually a zero-terminated string and is often displayed
in the window.
pszClass Points to the registered class name. This field is either
an application-specified name (defined by the
WinRegisterClass function), the name of a preregistered WC
class, or a WC constant. For a list of control classes
(WC_) see the ◄Control classes► topic.
hwndParent Identifies the parent window of the new window. This field
can be any valid window handle.
See Also
WinCreateWindow, WM_CREATE
♦