msos2.hlp (Table of Contents; Topic list)
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