Ask Learn
Preview
Please sign in to use this experience.
Sign inThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
A version of this page is also available for
4/8/2010
This function creates an overlapped, pop-up, or child window. It specifies the window class, window title, window style, and, optionally, the initial position and size of the window. This function also specifies the window's parent.
HWND CreateWindow(
LPCTSTR lpClassName,
LPCTSTR lpWindowName,
DWORD dwStyle,
int x,
int y,
int nWidth,
int nHeight,
HWND hWndParent,
HMENU hMenu,
HANDLE hInstance,
PVOID lpParam
);
lpClassName
[in] Long pointer to an atom or null-terminated string. If this parameter is an atom, it must be a global atom created by a previous call to the RegisterClass function. The atom must be in the low-order word of lpClassName; the high-order word must be zero.
If lpClassName is a string, it specifies the window class name. The class name can be any name registered with the RegisterClass function or any of the predefined control-class names. For a complete list, see the Remarks section.
lpWindowName
[in] Long pointer to a null-terminated string that specifies the window name.
If the window style specifies a title bar, the window title pointed to by lpWindowName is displayed in the title bar. When using CreateWindow to create controls, such as buttons, check boxes, and static controls, use lpWindowName to specify the text of the control.
dwStyle
[in] Specifies the style of the window being created. This parameter can be a combination of the following window styles, plus the control styles indicated in the Remarks section.
Value | Description |
---|---|
WS_BORDER |
Creates a window that has a thin-line border. |
WS_CAPTION |
Creates a window that has a title bar (includes the WS_BORDER style). |
WS_CHILD |
Creates a child window. This style cannot be used with the WS_POPUP style. |
WS_CLIPCHILDREN |
Excludes the area occupied by child windows when drawing occurs within the parent window. This style is used when creating the parent window. |
WS_CLIPSIBLINGS |
Clips child windows relative to each other; that is, when a particular child window receives a WM_PAINT message, the WS_CLIPSIBLINGS style clips all other overlapping child windows out of the region of the child window to be updated. If WS_CLIPSIBLINGS is not specified and child windows overlap, it is possible, when drawing within the client area of a child window, to draw within the client area of a neighboring child window. |
WS_DISABLED |
Creates a window that is initially disabled. A disabled window cannot receive input from the user. |
WS_DLGFRAME |
Creates a window that has a border of a style typically used with dialog boxes. A window with this style cannot have a title bar. |
WS_GROUP |
Specifies the first control of a group of controls. The group consists of this first control and all controls defined after it, up to the next control with the WS_GROUP style. The first control in each group usually has the WS_TABSTOP style so that the user can move from group to group. The user can subsequently change the keyboard focus from one control in the group to the next control in the group by using the direction keys. |
WS_HSCROLL |
Creates a window that has a horizontal scroll bar. |
WS_OVERLAPPED |
Creates an overlapped window. An overlapped window has a title bar and a border. |
WS_OVERLAPPEDWINDOW |
Creates an overlapped window with the WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX, and WS_MAXIMIZEBOX styles. > [!NOTE] > Although WS_OVERLAPPEDWINDOW is not supported in Windows Embedded CE, the functionality can still be achieved by obtaining a bitwise OR of the style flags WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX, and WS_MAXIMIZEBOX. |
WS_POPUP |
Creates a pop-up window. This style cannot be used with the WS_CHILD style. |
WS_SIZEBOX |
Creates a window that has a sizing border. Same as the WS_THICKFRAME style. |
WS_SYSMENU |
Creates a window that has a Close (X) button in the non-client area. |
WS_TABSTOP |
Specifies a control that can receive the keyboard focus when the user presses the TAB key. Pressing the TAB key changes the keyboard focus to the next control with the WS_TABSTOP style. |
WS_THICKFRAME |
Creates a window that has a sizing border. Same as the WS_SIZEBOX style. |
WS_VISIBLE |
Creates a window that is initially visible. |
WS_VSCROLL |
Creates a window that has a vertical scroll bar. |
x
[in] Specifies the initial horizontal position of the window. For an overlapped or pop-up window, the x parameter is the initial x-coordinate of the window's upper-left corner, in screen coordinates. For a child window, x is the x-coordinate of the upper-left corner of the window relative to the upper-left corner of the parent window's client area.
If this parameter is set to CW_USEDEFAULT, the system selects the default position for the window's upper-left corner and ignores the y parameter. CW_USEDEFAULT is valid only for overlapped windows; if it is specified for a pop-up or child window, the x and y parameters are set to zero.
y
[in] Specifies the initial vertical position of the window. For an overlapped or pop-up window, the y parameter is the initial y-coordinate of the window's upper-left corner, in screen coordinates. For a child window, y is the initial y-coordinate of the upper-left corner of the child window relative to the upper-left corner of the parent window's client area. For a list box, y is the initial y-coordinate of the upper-left corner of the list box's client area relative to the upper-left corner of the parent window's client area.
If an overlapped window is created with the WS_VISIBLE style bit set and the x parameter is set to CW_USEDEFAULT, the system ignores the y parameter.
A handle to the new window indicates success. NULL indicates failure. To get extended error information, call GetLastError.
Here, failure to create a window initiates DEBUGMSG:
g_hwndMain = CreateWindow (
TEXT ("AnxJTest Class"),
lpstrWndTitle,
WS_VISIBLE,
0, 0, SCREEN_WIDTH, SCREEN_HEIGHT,
NULL, NULL, g_hInstance, NULL);
if (!g_hwndMain) {
DEBUGMSG(ZONE_VERBOSE | ZONE_ERROR,
(TEXT ("Could not create main window.")));
return FALSE;
}
The CreateWindow function does not support the WM_PARENTNOTIFY message.
CreateWindow is implemented as a macro. It is defined as CreateWindowEx, but with the dwExStyle parameter set to 0L.
Menu bars are not supported. The hMenu parameter must be NULL, unless it is used as a child-window identifier.
The MDICLIENT window class is not supported.
The dwStyle parameter can be a combination of the window styles and control styles documented in Window and Message Box Styles and Control Styles.
The following dwStyle flags are not supported for Windows Embedded CE:
WS_CHILDWINDOW |
WS_ICONIC |
WS_POPUPWINDOW |
|
The following dwStyle flags are not supported for controls and dialog boxes:
Unsupported button styles |
Unsupported static control styles |
BS_LEFTTEXT |
SS_BLACKFRAME |
BS_TEXT |
SS_BLACKRECT |
BS_USERBUTTON |
SS_GRAYFRAME |
Unsupported combo box styles |
SS_GRAYRECT |
CBS_OWNERDRAWFIXED |
SS_METAPICT |
CBS_OWNERDRAWVARIABLE |
SS_REALSIZEIMAGE |
CBS_SIMPLE |
SS_RIGHTIMAGE |
Unsupported list box control styles |
SS_RIGHTJUST |
LBS_NODATA |
SS_SIMPLE |
LBS_STANDARD |
SS_SUNKEN |
Unsupported scroll bar styles |
SS_WHITEFRAME |
SBS_BOTTOMALIGN |
SS_WHITERECT |
SBS_RIGHTALIGN |
Unsupported dialog box styles |
SBS_SIZEBOXBOTTOMRIGHTALIGN |
DS_ABSALIGN |
SBS_SIZEGRIP |
DS_CENTERMOUSE |
|
DS_CONTEXTHELP |
|
DS_FIXEDSYS |
|
DS_NOFAILCREATE |
|
DS_NOIDLEMSG |
|
DS_SYSMODAL |
You can use the BS_OWNERDRAW style as a substitute for the BS_USERBUTTON style.
Combine the BS_MULTILINE style with the BS_PUSHBUTTON style to wrap text on a button.
You can use the SS_LEFT or SS_LEFTNOWORDWRAP style instead of the SS_SIMPLE style for static controls.
All windows implicitly have the WS_CLIPSIBLINGS and WS_CLIPCHILDREN styles.
Windows CE 1.0 does not support owned windows, except for dialog boxes. If the hwndParent parameter is not NULL, the window is implicitly given the WS_CHILD style.
Windows CE 1.0 does not support menu bars.
For Windows CE 2.10 and later, if nWidth and nHeight are set to CW_USEDEFAULT, the child window has dimensions of 0 x 0.
Before returning, CreateWindow sends a WM_CREATE message to the window procedure. For overlapped, pop-up, and child windows, CreateWindow sends WM_CREATE messages to the window. The lParam parameter of the WM_CREATE message contains a pointer to a CREATESTRUCT structure. If the WS_VISIBLE style is specified, CreateWindow sends the window all the messages required to activate and show the window.
The following predefined control classes can be specified in the lpClassName parameter. Note the corresponding control styles you can use in the dwStyle parameter.
STATIC
Designates a simple text field, box, or rectangle used to label, box, or separate other controls. Static controls take no input and provide no output. For more information about static controls and the styles you can specify in the dwStyle parameter, see Control Styles.
Note
If you specify Windows 4.x when linking your application, its windows cannot have caption buttons unless they also have window menus. This is not a requirement if you specify Windows 3.x when linking your application.
Header | winuser.h |
Windows Embedded CE | Windows CE 1.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |
Windows Functions
CreateDialog
CREATESTRUCT
CreateWindowEx
DialogBox
DLGTEMPLATE
LB_GETTEXT
LB_SETCOLUMNWIDTH
MessageBox
RegisterClass
SetForegroundWindow
WM_COMMAND
WM_CREATE
WM_DELETEITEM
WM_DRAWITEM
WM_MEASUREITEM
WM_PAINT
WM_SETFONT
WM_SETREDRAW
Windows Functions
Please sign in to use this experience.
Sign in