Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function creates an overlapped, pop-up, or child window with an extended style; otherwise, this function is identical to the CreateWindowfunction.
HWND CreateWindowEx( DWORD dwExStyle , LPCTSTR lpClassName , LPCTSTR lpWindowName , DWORD dwStyle , int x , int y , int nWidth , int nHeight , HWND hWndParent , HMENU hMenu , HINSTANCE hInstance , LPVOID lpParam );
Parameters
Value | Description |
---|---|
WS_EX_ACCEPTFILES | Specifies that a window created with this style accepts drag-drop files. |
WS_EX_APPWINDOW | Forces a top-level window onto the taskbar when the window is visible. |
WS_EX_CLIENTEDGE | Specifies that a window has a border with a sunken edge. |
WS_EX_DLGMODALFRAME | Creates a window that has a double border; the window can, optionally, be created with a title bar by specifying the WS_CAPTION style in the dwStyleparameter. |
WS_EX_LEFT | Creates a window that has generic "left-aligned" properties. This is the default. |
WS_EX_LEFTSCROLLBAR | If the shell language is Hebrew, Arabic, or another language that supports reading order alignment, the vertical scroll bar (if present) is to the left of the client area. For other languages, the style is ignored. |
WS_EX_LTRREADING | The window text is displayed using left-to-right reading-order properties. This is the default. |
WS_EX_MDICHILD | Creates an MDI child window. |
WS_EX_NOACTIVATE | A top-level window created with this style cannot be activated. If a child window has this style, tapping it does not cause its top-level parent to be activated. A window that has this style receives stylus events, but neither it nor its child windows can get the focus. Supported in Windows CE versions 2.0 and later. |
WS_EX_NOANIMATION | A window created with this style does not show animated exploding and imploding rectangles, and does not have a button on the taskbar. Supported in Windows CE versions 2.0 and later. |
WS_EX_NOPARENTNOTIFY | Specifies that a child window created with this style does not send the WM_PARENTNOTIFY message to its parent window when it is created or destroyed. |
WS_EX_OVERLAPPEDWINDOW | Combines the WS_EX_CLIENTEDGE and WS_EX_WINDOWEDGE styles. |
WS_EX_PALETTEWINDOW | Combines the WS_EX_WINDOWEDGE, WS_EX_TOOLWINDOW, and WS_EX_TOPMOST styles. |
WS_EX_RIGHT | The window has generic "right-aligned" properties. This depends on the window class. This style has an effect only if the shell language is Hebrew, Arabic, or another language that supports reading-order alignment; otherwise, the style is ignored. |
WS_EX_RIGHTSCROLLBAR | Vertical scroll bar (if present) is to the right of the client area. This is the default. |
WS_EX_RTLREADING | If the shell language is Hebrew, Arabic, or another language that supports reading-order alignment, the window text is displayed using right-to-left reading-order properties. For other languages, the style is ignored. |
WS_EX_STATICEDGE | Creates a window with a three-dimensional border style intended to be used for items that do not accept user input. |
WS_EX_TOOLWINDOW | Creates a tool window; that is, a window intended to be used as a floating toolbar. A tool window has a title bar that is shorter than a normal title bar, and the window title is drawn using a smaller font. A tool window does not appear in the taskbar or in the dialog that appears when the user presses ALT+TAB. If a tool window has a system menu, its icon is not displayed on the title bar. However, you can display the system menu by right-clicking or by typing ALT+SPACE. |
WS_EX_TOPMOST | Specifies that a window created with this style should be placed above all non-topmost windows and should stay above them, even when the window is deactivated. To add or remove this style, use the SetWindowPosfunction. |
WS_EX_TRANSPARENT | Specifies that a window created with this style
should not be painted until siblings beneath the window (that were
created by the same thread) have been painted. The window appears
transparent because the bits of underlying sibling windows have
already been painted.
To achieve transparency without these restrictions, use the SetWindowRgnfunction. |
WS_EX_WINDOWEDGE | Specifies that a window has a border with a raised edge. |
Using the WS_EX_RIGHT style for static or edit controls has the same effect as using the SS_RIGHT or ES_RIGHT style, respectively. Using this style with button controls has the same effect as using BS_RIGHT and BS_RIGHTBUTTON styles.
If lpClassNameis a string, it specifies the window class name. The class name can be any name registered with the RegisterClassfunction or any of the predefined control-class names.
If the window style specifies a title bar, the window title pointed to by lpWindowNameis displayed in the title bar. When using CreateWindowto create controls, such as buttons, check boxes, and static controls, use lpWindowNameto specify the text of the control.
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_CHILDWINDOW | Same as the WS_CHILD 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_PAINTmessage, 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_ICONIC | Creates a window that is initially minimized. Same as the WS_MINIMIZE style. |
WS_MAXIMIZE | Creates a window that is initially maximized. |
WS_MAXIMIZEBOX | Creates a window that has a Maximizebutton. Cannot be combined with the WS_EX_CONTEXTHELP style. |
WS_MINIMIZE | Creates a window that is initially minimized. Same as the WS_ICONIC style. |
WS_MINIMIZEBOX | Creates a window that has a Minimizebutton. Cannot be combined with the WS_EX_CONTEXTHELP style. |
WS_OVERLAPPED | Creates an overlapped window. An overlapped window has a title bar and a border. Same as the WS_TILED style. |
WS_OVERLAPPEDWINDOW | Creates an overlapped window with the WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX, and WS_MAXIMIZEBOX styles. Same as the WS_TILEDWINDOW style. |
WS_POPUP | Creates a pop-up window. This style cannot be used with the WS_CHILD style. |
WS_POPUPWINDOW | Creates a pop-up window with WS_BORDER, WS_POPUP, and WS_SYSMENU styles. The WS_CAPTION and WS_POPUPWINDOW styles must be combined to make the window menu visible. |
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_TILED | Creates an overlapped window. An overlapped window has a title bar and a border. Same as the WS_OVERLAPPED style. |
WS_TILEDWINDOW | Creates an overlapped window with the WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX, and WS_MAXIMIZEBOX styles. Same as the WS_OVERLAPPEDWINDOW style. |
WS_VISIBLE | Creates a window that is initially visible. |
WS_VSCROLL | Creates a window that has a vertical scroll bar. |
If xis set to CW_USEDEFAULT, the system selects the default position for the window's upper-left corner and ignores the yparameter. CW_USEDEFAULT is valid only for overlapped windows; if it is specified for a pop-up or child window, the xand yparameters are set to zero.
If an overlapped window is created with the WS_VISIBLE style bit set and the xparameter is set to CW_USEDEFAULT, the system ignores the yparameter.
Return Values
A handle to the new window indicates success. NULL indicates failure. To get extended error information, call GetLastError.
Remarks
Windows CE does not support stand-alone menu bars. The hMenuparameter must be NULL, unless it is used as a child-window identifier.
For more information about creating a window and for full descriptions of the other parameters of CreateWindowEx, see CreateWindow.
The following dwExStyleflags are not supported:
WS_EX_ACCEPTFILES | WS_EX_NOPARENTNOTIFY |
WS_EX_APPWINDOW | WS_EX_PALETTEWINDOW |
WS_EX_CONTROLPARENT | WS_EX_RIGHT |
WS_EX_LEFT | WS_EX_RIGHTSCROLLBAR |
WS_EX_LEFTSCROLLBAR | WS_EX_RTLREADING |
WS_EX_LTRREADING | WS_EX_TRANSPARENT |
WS_EX_MDICHILD |
Windows CE version 1.0 does not support the WS_EX_TOPMOST style. Versions 2.0 and later do.
Windows CE versions 1.0 and 2.0 do not support the WS_EX_TOOLWINDOW style. Versions 2.10 and later do.
The following dwStyleflags are not supported:
WS_CHILDWINDOW | WS_ICONIC |
WS_MAXIMIZE | WS_MAXIMIZEBOX |
WS_MINIMIZE | WS_MINIMIZEBOX |
WS_OVERLAPPEDWINDOW | WS_POPUPWINDOW |
WS_SIZEBOX | WS_THICKFRAME |
WS_TILED | WS_TILEDWINDOW |
All windows implicitly have the WS_CLIPSIBLINGS and WS_CLIPCHILDREN styles.
Windows CE version 1.0 does not support owned windows, except for dialog boxes.
If the hwndParentparameter is not NULL and WS_OVERLAPPED is specified, Windows CE resolves the conflict by implicitly giving the WS_CHILD style to the window. This gives the window a parent, not an owner. Thus, a call to the GetWindowfunction with the GW_OWNER value set returns NULL.
The CreateWindowExfunction sends WM_NCCALCSIZE and WM_CREATE messages to the window being created.
The following predefined control classes can be specified in the lpClassNameparameter. Note the corresponding control styles you can use in the dwStyleparameter.
Requirements
Runs on | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 1.0 and later | Winuser.h |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
CREATESTRUCT, CreateWindow, RegisterClass, SetWindowPos, WM_CREATE, WM_PAINT