CWnd

Win32++

CWnd Class

Description

The CWnd class represents a window. CWnd handles such things as window creation and window destruction, as well as determining how the window messages are handled. Each window created by Win32++ is a CWnd object, or an object derived from CWnd. Many of the classes in Win32++ are inherited from CWnd, including CFrame, CMDIChild, CMDIFrame, CMenuBar, CReBar, CStatusBar, and CToolBar.

Inherit from this class in your own application to create windows. The WndProc member function is called whenever the window associated with the CWnd object receives a Window message. Override WndProc to handle window messages, and pass all unhandled messages on to WndProcDefault.

CWnd Members:

Construction

CWnd	CWnd(); Constructs a CWnd object

Operations

operator HWND	operator HWND() const; Returns the HWND belonging to this CWnd.
Attach	virtual BOOL Attach(HWND hWnd); Attaches a CWnd object to an existing window.
AttachDlgItem	virtual BOOL AttachDlgItem(UINT nID, CWnd* pParent); Attaches a CWnd object to a dialog item.
CenterWindow	virtual void CenterWindow() const; Positions the window over the center of its parent.
Create	virtual HWND Create(CWnd* pParent = NULL); Creates the window with default parameters. Use PreCreate to set the default parameters.
CreateEx	virtual HWND CreateEx(DWORD dwExStyle, LPCTSTR lpszClassName, LPCTSTR lpszWindowName, DWORD dwStyle, int x, int y, int nWidth, int nHeight, HWND hwndParent, HMENU nIDorHMenu, LPVOID lpParam = NULL); virtual HWND CreateEx(DWORD dwExStyle, LPCTSTR lpszClassName, LPCTSTR lpszWindowName, DWORD dwStyle, const RECT& rc, CWnd* pParent, UINT nID, LPVOID lpParam = NULL); Creates the window by specifying each parameter.
Destroy	virtual void Destroy(); Destroys the window associated with the CWnd, and returns the CWnd to its default state.
Detach	virtual HWND Detach(); Detaches a window from a CWnd object. It reverses an attach.
FromHandle	static CWnd* FromHandle(HWND hWnd); Returns the CWnd associated with the specified window handle. If a CWnd object doesn't already exist for this HWND, a temporary CWnd object is created. This temporary CWnd will be deleted sometime after the processing of the current message is complete.
FromHandlePermanent	static CWnd* FromHandlePermanent(HWND hWnd); Returns the CWnd associated with the specified window handle. If a CWnd object doesn't already exist for this HWND, this function returns NULL.
FinalWindowProc	virtual LRESULT FinalWindowProc(UINT uMsg, WPARAM wParam, LPARAM lParam); Passes messages on to the appropriate default window procedure. When a message is handled, the function should either return FinalWindowProc or a specific value recommended in the Windows API documentation.
Invalidate	virtual void Invalidate(BOOL bErase = TRUE) const; Invalidates the entire window. The window will be redrawn when the next WM_PAINT message is processed.
SetIconLarge	virtual HICON SetIconLarge(int nIcon); Loads the large icon from the specified resource, and assigns it to the window.
SetIconSmall	virtual HICON SetIconSmall(int nIcon); Loads the small icon from the specified resource, and assigns it to to the window.
WndProcDefault	virtual LRESULT WndProcDefault(UINT uMsg, WPARAM wParam, LPARAM lParam); Don't override this function. Pass all unhandled messages to WndProcDefault when overriding WndProc.

Overridables

OnAttach	virtual void OnAttach(); Called when a window is attached to the CWnd. Note that window controls are subclassed after they are created, and call OnAttach.
OnCommand	virtual BOOL OnCommand(WPARAM wParam, LPARAM lParam); Called when the user selects a command, typically in response to a menu or toolbar button.
OnClose	virtual void OnClose(); Called in response to WM_CLOSE. Override to suppress destroying the window. A WM_CLOSE is sent by SendMessage(WM_SYSCOMMAND, SC_CLOSE, 0) or by clicking the X to close the window.
OnCreate	virtual void OnCreate(); Called during window creation. Override this function to perform tasks such as creating child windows. Note that window controls are attached after they are created, and don't call OnCreate.
OnDestroy	virtual void OnDestroy(); This function is called when a window is destroyed. Override it to do additional tasks, such as ending the application with PostQuitMessage..
OnDraw	virtual void OnDraw(CDC* pDC); Called when part of the window is about to be redrawn. Override this function to specify how the window should be drawn.
OnEraseBkGnd	virtual BOOL OnEraseBkgnd(CDC* pDC); Called when part of the window background is erased. Override this function to specify how the window's background should be drawn.
OnInitialUpdate	virtual void OnInitialUpdate(); Called after the window is created. Override this function to perform tasks once the window is created.
OnMenuUpdate	virtual void OnMenuUpdate(UINT nID); Called when a popup menu is about to be displayed. Override this function to set or clear the check box or radio button to menu items.
OnMessageReflect	virtual LRESULT OnMessageReflect(UINT uMsg, WPARAM wParam, LPARAM lParam); Called when a notification message is sent to the parent. Override this function to handle these notification messages in the CWnd that generated them.
OnNotify	virtual LRESULT OnNotify(WPARAM wParam, LPARAM lParam); Called when a WM_NOTIFY message is received from a child window. Override this function to handle notifications in the parent's CWnd.
OnNotifyReflect	virtual LRESULT OnNotifyReflect(WPARAM wParam, LPARAM lParam); Called when a WM_NOTIFY message is sent to the parent. Override this function to handle notifications in the CWnd that generated them.
PreCreate	virtual void PreCreate(CREATESTRUCT& cs); Override this function to set the window creation parameters used by Create.
PreRegisterClass	virtual void PreRegisterClass(WNDCLASS& wc); Override the function to set the window class parameters used by Create.
PreTranslateMessage	virtual BOOL PreTranslateMessage(MSG* pMsg); Override this function to filter mouse and keyboard messages prior to being passed to the message loop.
WndProc	virtual LRESULT WndProc(UINT uMsg, WPARAM wParam, LPARAM lParam); Override this function to specify how the messages for this window are to be handled. Return all unhandled messages to WndProcDefault.

Attributes

FromHandle	static CWnd* FromHandle(HWND hWnd); Returns a pointer to the CWnd object, given the window handle (HWND).
GetHwnd	HWND GetHwnd() const; Returns the handle of the window associated with CWnd.
GetPrevWindowProc	WNDPROC GetPrevWindowProc() const; Pointer to the Window Procedure prior to it being subclassed.

Member Variables

m_hWnd

HWND m_hWnd;

Handle to the CWnd's window.

Wrappers for Window API functions and messages (don't override these).

BeginPaint	CDC* BeginPaint(PAINTSTRUCT& ps) const; Prepares the specified window for painting and fills a PAINTSTRUCT structure with information about the painting.
BringWindowToTop	BOOL BringWindowToTop() const; Brings the window to the top of the Z order. If the window is a top-level window, it is activated. If the window is a child window, the top-level parent window associated with the child window is activated.
CallWindowProc	LRESULT CallWindowProc(WNDPROC lpPrevWndFunc, UINT Msg, WPARAM wParam, LPARAM lParam) const; Passes message information to the specified window procedure.
CheckDlgButton	BOOL CheckDlgButton(int nIDButton, UINT uCheck) const; Changes the check state of a button control.
CheckRadioButton	BOOL CheckRadioButton(int nIDFirstButton, int nIDLastButton, int nIDCheckButton) const; Adds a check mark to (checks) a specified radio button in a group and removes a check mark from (clears) all other radio buttons in the group.
ChildWindowFromPoint	CWnd* ChildWindowFromPoint(POINT pt) const; Determines which, if any, of the child windows belonging to a parent window contains the specified point. The search is restricted to immediate child windows. Grandchildren, and deeper descendant windows are not searched.
ClientToScreen	BOOL ClientToScreen(POINT& pt) const; BOOL ClientToScreen(RECT& rc) const; Converts the client-area coordinates of a specified point to screen coordinates..
CloseWindow	BOOL CloseWindow() const; Minimizes (but does not destroy) the window. This function is not supported on WinCE.
DefWindowProc	LRESULT DefWindowProc(UINT uMsg, WPARAM wParam, LPARAM lParam) const; Calls the default window procedure to provide default processing for any window messages that an application does not process.
DeferWindowPos	HDWP DeferWindowPos(HDWP hWinPosInfo, const CWnd* pInsertAfter, int x, int y, int cx, int cy, UINT uFlags) const; HDWP DeferWindowPos(HDWP hWinPosInfo, const CWnd* pInsertAfter, const RECT& rc, UINT uFlags) const; Updates the multiple window position structure for the window. The function then returns a handle to the updated structure.
DlgDirList	int DlgDirList(LPTSTR lpPathSpec, int nIDListBox, int nIDStaticPath, UINT uFileType) const; Replaces the contents of a list box with the names of the subdirectories and files in a specified directory. You can filter the list of names by specifying a set of file attributes. This function is not supported on WinCE.
DlgDirListComboBox	int DlgDirListComboBox(LPTSTR lpPathSpec, int nIDComboBox, int nIDStaticPath, UINT uFiletype) const; Replaces the contents of a combo box with the names of the subdirectories and files in a specified directory. You can filter the list of names by specifying a set of file attributes. This function is not supported on WinCE.
DlgDirSelectEx	BOOL DlgDirSelectEx(LPTSTR lpString, int nCount, int nIDListBox) const; Retrieves the current selection from a single-selection list box. It assumes that the list box has been filled by the DlgDirList function and that the selection is a drive letter, filename, or directory name. This function is not supported on WinCE.
DlgDirSelectComboBoxEx	BOOL DlgDirSelectComboBoxEx(LPTSTR lpString, int nCount, int nIDComboBox) const; Retrieves the current selection from a combo box filled by using the DlgDirListComboBox function. The selection is interpreted as a drive letter, a file, or a directory name. This function is not supported on WinCE.
DrawAnimatedRects	BOOL DrawAnimatedRects(int idAni, RECT& rcFrom, RECT& rcTo) const; Draws a wire-frame rectangle and animates it to indicate the opening of an icon or the minimizing or maximizing of a window. This function is not supported on WinCE.
DrawCaption	BOOL DrawCaption(CDC* pDC, RECT& rc, UINT uFlags) const; Draws a window caption. This function is not supported on WinCE.
DrawMenuBar	BOOL DrawMenuBar() const; Redraws the menu bar of the window. If the menu bar changes after the system has created the window, this function must be called to draw the changed menu bar.
EnableScrollBar	BOOL EnableScrollBar(UINT uSBflags, UINT uArrows) const; Enables or disables one or both scroll bar arrows. This function is not supported on WinCE.
EnableWindow	BOOL EnableWindow(BOOL bEnable = TRUE) const; The EnableWindow function enables or disables mouse and keyboard input to the specified window or control. When input is disabled, the window does not receive input such as mouse clicks and key presses. When input is enabled, the window receives all input.
EndPaint	BOOL EndPaint(PAINTSTRUCT& ps) const; Marks the end of painting in the specified window. This function is required for each call to the BeginPaint function, but only after painting is complete.
GetActiveWindow	CWnd* GetActiveWindow() const; Returns the pointer to the active window. This pointer might be temporary, so don't save it for later use.
GetAncestor	CWnd* GetAncestor(UINT gaFlag = 3 /= GA_ROOTOWNER/) const; Returns the pointer to the ancestor window. This pointer might be temporary, so don't save it for later use.
GetCapture	CWnd* GetCapture() const; Returns the pointer to the window (if any) that has captured the mouse. This pointer might be temporary, so don't save it for later use.
GetClassLongPtr	ULONG_PTR GetClassLongPtr(int nIndex) const; Retrieves the specified value from the WNDCLASSEX structure associated with the window.
GetClassName	LPCTSTR GetClassName() const; Returns a pointer to a TCHAR array containing the class name of the window.
GetClientRect	CRect GetClientRect() const; Retrieves the coordinates of a window's client area. The client coordinates specify the upper-left and lower-right corners of the client area. Because client coordinates are relative to the upper-left corner of a window's client area, the coordinates of the upper-left corner are (0,0).
GetDC	CDC* GetDC() const; Retrieves a pointer to the display device context (CDC) for the client area of the window.
GetDCEx	CDC* GetDCEx(HRGN hrgnClip, DWORD flags) const; Retrieves a pointer to a display device context (CDC) for the client area of the window. This function is an extension to the GedDC function, which gives an application more control over how and whether clipping occurs in the client area.
GetDesktopWindow	CWnd* GetDesktopWindow() const; Retrieves a pointer to the desktop window. This pointer might be temporary, so don't save it for later use.
GetDlgCtrlID	int GetDlgCtrlID() const; Retrieves the control ID value for any child window.
GetDlgItem	CWnd* GetDlgItem(int nIDDlgItem) const; Retrieves a pointer to a control in the dialog box. This pointer might be temporary, so don't save it for later use.
GetDlgItemInt	UINT GetDlgItemInt(int nIDDlgItem, BOOL* lpTranslated, BOOL bSigned) const; Translates the text of a specified control in a dialog box into an integer value.
GetDlgItemText	LPCTSTR GetDlgItemText(int nIDDlgItem) const; Retrieves the title or text associated with a control in a dialog.
GetFont	CFont* GetFont() const; Retrieves a handle to the font assigned to the window.
GetIcon	HICON GetIcon(BOOL bBigIcon) const; Retrieves a handle to the icon assigned to the window.
GetLastActivePopup	CWnd* GetLastActivePopup() const; Retrieves the pointer to the pop-up window owned by the window which was most recently active. This pointer might be temporary, so don't save it for later use.
GetMenu	CMenu* GetMenu() const; Retrieves a handle to the menu assigned to the window. This function is not supported on WinCE.
GetNextDlgGroupItem	CWnd* GetNextDlgGroupItem(CWnd* pCtl, BOOL bPrevious) const; Retrieves a handle to the first control in a group of controls that precedes (or follows) the specified control in a dialog box.
GetNextDlgTabItem	CWnd* GetNextDlgTabItem(CWnd* pCtl, BOOL bPrevious) const; Retrieves a handle to the first control that has the WS_TABSTOP style that precedes (or follows) the specified control.
GetParent	CWnd* GetParent() const; Retrieves a pointer to the window's parent or owner (if any). This pointer might be temporary, so don't save it for later use.
GetScrollInfo	BOOL GetScrollInfo(int fnBar, SCROLLINFO& si) const; Retrieves the parameters of a scroll bar, including the minimum and maximum scrolling positions, the page size, and the position of the scroll box (thumb).
GetScrollPos	int GetScrollPos(int nBar) const; Retrieves the current position of the scroll box (thumb) in the specified scroll bar. The current position is a relative value that depends on the current scrolling range. For example, if the scrolling range is 0 through 100 and the scroll box is in the middle of the bar, the current position is 50. This function is not supported on WinCE. New applications should use the GetScrollInfo function.
GetScrollRange	BOOL GetScrollRange(int nBar, int& MinPos, int& MaxPos) const; Retrieves the current minimum and maximum scroll box (thumb) positions for the specified scroll bar. This function is not supported on WinCE. New applications should use the GetScrollInfo function.
GetSystemMenu	CMenu* GetSystemMenu(BOOL bRevert) const; Allows the application to access the window menu (also known as the system menu or the control menu) for copying and modifying. This function is not supported on WinCE.
GetTopWindow	CWnd* GetTopWindow() const; Retrieves a pointer to the child window at the top of the Z order. This pointer might be temporary, so don't save it for later use.
GetUpdateRect	CRect GetUpdateRect(BOOL bErase) const; Retrieves the coordinates of the smallest rectangle that completely encloses the update region of the specified window.
GetUpdateRgn	int GetUpdateRgn(CRgn* pRgn, BOOL bErase) const; Retrieves the update region of a window by copying it into the specified region.
GetWindow	CWnd* GetWindow(UINT uCmd) const; Retrieves a pointer to a window that has the specified relationship (Z-Order or owner) to the window. This pointer might be temporary, so don't save it for later use.
GetWindowDC	CDC* GetWindowDC() const; Retrieves the device context (DC) for the entire window, including title bar, menus, and scroll bars. A window device context permits painting anywhere in a window, because the origin of the device context is the upper-left corner of the window instead of the client area.
GetWindowLongPtr	LONG_PTR GetWindowLongPtr(int nIndex) const; Retrieves information about the window. The function also retrieves the value at a specified offset into the extra window memory.
GetWindowPlacement	BOOL GetWindowPlacement(WINDOWPLACEMENT& pWndpl) const; Retrieves the show state and the restored, minimized, and maximized positions of the window. This function is not supported on WinCE.
GetWindowRect	CRect GetWindowRect() const; Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen.
GetWindowText	LPCTSTR GetWindowText() const; Retrieves the title or text associated with the window.
GetWindowTextLength	int GetWindowTextLength() const; Retrieves the length, in characters, of the specified window's text.
HiliteMenuItem	BOOL HiliteMenuItem(CMenu* pMenu, UINT uItemHilite, UINT uHilite) const; Highlights or removes the highlighting from an item in a menu bar. This function is not supported on WinCE.
InvalidateRect	BOOL InvalidateRect(LPCRECT lpRect, BOOL bErase = TRUE) const; The InvalidateRect function adds a rectangle to the window's update region. The update region represents the portion of the window's client area that must be redrawn.
InvalidateRgn	BOOL InvalidateRgn(CRgn* pRgn, BOOL bErase = TRUE) const; The InvalidateRgn function invalidates the client area within the specified region by adding it to the current update region of a window. The invalidated region, along with all other areas in the update region, is marked for painting when the next WM_PAINT message occurs.
IsChild	BOOL IsChild(CWnd* pChild) const; Tests whether a window is a child window or descendant window of a specified parent window. A child window is the direct descendant of a specified parent window if that parent window is in the chain of parent windows; the chain of parent windows leads from the original overlapped or pop-up window to the child window.
IsDialogMessage	BOOL IsDialogMessage(LPMSG lpMsg) const; Determines whether a message is intended for the specified dialog box and, if it is, processes the message.
IsDlgButtonChecked	UINT IsDlgButtonChecked(int nIDButton) const; Determines whether a button control has a check mark next to it or whether a three-state button control is grayed, checked, or neither.
IsIconic	BOOL IsIconic() const; Determines whether the window is minimized (iconic). This function is not supported on WinCE.
IsWindow	BOOL IsWindow() const; Determines whether the window handle identifies an existing window.
IsWindowEnabled	BOOL IsWindowEnabled() const; Determines whether the window is enabled for mouse and keyboard input.
IsWindowVisible	BOOL IsWindowVisible() const; Retrieves the visibility state of the window.
IsZoomed	BOOL IsZoomed() const; Determines whether the window is maximized. This function is not supported on WinCE.
KillTimer	BOOL KillTimer(UINT_PTR uIDEvent) const; Destroys the specified timer.
LockWindowUpdate	BOOL LockWindowUpdate() const; Disables or enables drawing in the window. Only one window can be locked at a time.This function is not supported on WinCE.
MapWindowPoints	void MapWindowPoints(CWnd* pWndTo, POINT& pt) const; void MapWindowPoints(CWnd* pWndTo, RECT& rc) const; void MapWindowPoints(CWnd* pWndTo, LPPOINT ptArray, UINT nCount) const; Converts (maps) a set of points from a coordinate space relative to one window to a coordinate space relative to another window.
MessageBox	int MessageBox(LPCTSTR lpText, LPCTSTR lpCaption, UINT uType) const; Creates, displays, and operates a message box. The message box contains an application-defined message and title, plus any combination of predefined icons and push buttons.
MoveWindow	BOOL MoveWindow(int x, int y, int nWidth, int nHeight, BOOL bRepaint = TRUE) const; BOOL MoveWindow(const RECT& rc, BOOL bRepaint = TRUE) const; The MoveWindow function changes the position and dimensions of the window.
OpenIcon	BOOL OpenIcon() const; Restores a minimized (iconic) window to its previous size and position, and then activates the window.
PostMessage	BOOL PostMessage(UINT uMsg, WPARAM wParam = 0L, LPARAM lParam = 0L) const; BOOL PostMessage(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam) const; The PostMessage function places (posts) a message in the message queue associated with the thread that created the window and returns without waiting for the thread to process the message.
Print	void Print(CDC* pDC, DWORD dwFlags) const; Requests that the window draw itself in the specified device context, most commonly in a printer device context. This function is not supported on WinCE.
RedrawWindow	BOOL RedrawWindow(LPCRECT lpRectUpdate = NULL, CRgn* pRgn = NULL, UINT flags = RDW_INVALIDATE \| RDW_UPDATENOW \| RDW_ERASE \| RDW_ALLCHILDREN) const; This function updates the specified rectangle or region in a window's client area.
ReleaseDC	int ReleaseDC(CDC* pDC) const; Releases a device context (DC), freeing it for use by other applications.
ScreenToClient	BOOL ScreenToClient(POINT& Point) const; BOOL ScreenToClient(RECT& rc) const; Converts the screen coordinates of a specified RECT or points on the screen to client-area coordinates.
ScrollWindow	BOOL ScrollWindow(int XAmount, int YAmount, LPCRECT prcScroll, LPCRECT prcClip) const; Scrolls the contents of the specified window's client area. This function is not supported on WinCE. New applications should use the ScrollWindowEx function.
ScrollWindowEx	int ScrollWindowEx(int dx, int dy, LPCRECT prcScroll, LPCRECT prcClip, CRgn* prgnUpdate, LPRECT prcUpdate, UINT flags) const; Scrolls the contents of the specified window's client area. This function is not supported on WinCE.
SendDlgItemMessage	LRESULT SendDlgItemMessage(int nIDDlgItem, UINT Msg, WPARAM wParam, LPARAM lParam) const; Sends a message to the specified control in a dialog box.
SendMessage	LRESULT SendMessage(UINT uMsg, WPARAM wParam = 0L, LPARAM lParam = 0L) const; LRESULT SendMessage(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam) const; The SendMessage function sends the specified message to a window or windows. It calls the window procedure for the window and does not return until the window procedure has processed the message.
SendNotifyMessage	BOOL SendNotifyMessage(UINT Msg, WPARAM wParam, LPARAM lParam) const; Sends the specified message to a window or windows. If the window was created by the calling thread, SendNotifyMessage calls the window procedure for the window and does not return until the window procedure has processed the message. If the window was created by a different thread, SendNotifyMessage passes the message to the window procedure and returns immediately; it does not wait for the window procedure to finish processing the message.
SetActiveWindow	CWnd* SetActiveWindow() const; Activates a window. The window will be brought into the foreground (top of Z-Order) if its application is in the foreground when the system activates the window.
SetCapture	CWnd* SetCapture() const; Sets the mouse capture to the window belonging to the current thread. SetCapture captures mouse input either when the mouse is over the capturing window, or when the mouse button was pressed while the mouse was over the capturing window and the button is still down. Only one window at a time can capture the mouse.
SetClassLongPtr	ULONG_PTR SetClassLongPtr(int nIndex, LONG_PTR dwNewLong) const; Replaces the specified value at the specified offset in the extra class memory or the WNDCLASSEX structure for the class to which the window belongs.
SetDlgItemInt	BOOL SetDlgItemInt(int nIDDlgItem, UINT uValue, BOOL bSigned) const; Sets the text of a control in a dialog box to the string representation of a specified integer value.
SetDlgItemText	BOOL SetDlgItemText(int nIDDlgItem, LPCTSTR lpString) const; Sets the title or text of a control in a dialog box.
SetFocus	CWnd* SetFocus() const; Sets the keyboard focus to the window.
SetFont	void SetFont(CFont pFont, BOOL bRedraw) const;; Specifies the font that a window will use when drawing text.
SetForegroundWindow	BOOL SetForegroundWindow() const; Puts the thread that created the window into the foreground and activates the window. Keyboard input is directed to the window, and various visual cues are changed for the user. The system assigns a slightly higher priority to the thread that created the foreground window than it does to other threads.
SetIcon	HICON SetIcon(HICON hIcon, BOOL bBigIcon) const; Associates a new large or small icon with the window..
SetMenu	BOOL SetMenu(CMenu* pMenu) const; Assigns a new menu to the window. This function is not supported on WinCE.
SetParent	CWnd* SetParent(CWnd* pWndParent) const; Changes the parent window of the specified child window.
SetRedraw	BOOL SetRedraw(BOOL bRedraw = TRUE) const; This function allows changes in the window to be redrawn or prevents changes in the window from being redrawn, by sending a WM_SETREDRAW message.
SetScrollInfo	int SetScrollInfo(int fnBar, const SCROLLINFO& si, BOOL fRedraw) const; Sets the parameters of a scroll bar, including the minimum and maximum scrolling positions, the page size, and the position of the scroll box (thumb). The function also redraws the scroll bar, if requested.
SetScrollPos	int SetScrollPos(int nBar, int nPos, BOOL bRedraw) const; Sets the position of the scroll box (thumb) in the specified scroll bar and, if requested, redraws the scroll bar to reflect the new position of the scroll box. New applications should use the SetScrollInfo function. This function is not supported on WinCE.
SetScrollRange	BOOL SetScrollRange(int nBar, int nMinPos, int nMaxPos, BOOL bRedraw) const; Sets the minimum and maximum scroll box positions for the specified scroll bar. New applications should use the SetScrollInfo function. This function is not supported on WinCE.
SetTimer	UINT_PTR SetTimer(UINT_PTR nIDEvent, UINT uElapse, TIMERPROC lpTimerFunc) const; Creates a timer with the specified time-out value.
SetWindowLongPtr	LONG_PTR SetWindowLongPtr(int nIndex, LONG_PTR dwNewLong) const; Changes an attribute of the window. The function also sets a value at the specified offset in the extra window memory.
SetWindowPlacement	BOOL SetWindowPlacement(const WINDOWPLACEMENT& wndpl) const; Sets the show state and the restored, minimized, and maximized positions of the window. This function is not supported on WinCE.
SetWindowPos	BOOL SetWindowPos(const CWnd* pInsertAfter, int x, int y, int cx, int cy, UINT uFlags) const; BOOL SetWindowPos(const CWnd* pInsertAfter, const RECT& rc, UINT uFlags) const; Changes the size, position, and Z order of a child, pop-up, or top-level window. Child, pop-up, and top-level windows are ordered according to their appearance on the screen. The topmost window receives the highest rank and is the first window in the Z order. The pInsertAfter can one of: &wndTop, &wndTopMost, &wndBottom, or &wndNoTopMost.
SetWindowRgn	int SetWindowRgn(CRgn* pRgn, BOOL bRedraw = TRUE) const; Sets the window region of a window. The window region determines the area within the window where the system permits drawing. The system does not display any portion of a window that lies outside of the window region. The system owns the region after a successful call to SetWindowRgn.
SetWindowText	BOOL SetWindowText(LPCTSTR lpString) const; Changes the text of the window's title bar (if it has one). If the window is a control, the text of the control is changed.
SetWindowTheme	HRESULT SetWindowTheme(LPCWSTR pszSubAppName, LPCWSTR pszSubIdList) const; Causes a window to use a different set of visual style information (XP Theme) than its class normally uses.
ShowOwnedPopups	BOOL ShowOwnedPopups(BOOL fShow) const; Shows or hides the all the pop-up windows owned by this window.
ShowScrollBar	BOOL ShowScrollBar(int nBar, BOOL bShow) const; Shows or hides the specified scroll bar. This function is not supported on WinCE.
ShowWindow	BOOL ShowWindow(int nCmdShow = SW_SHOWNORMAL) const; Sets the window's show state.
ShowWindowAsync	BOOL ShowWindowAsync(int nCmdShow) const; The ShowWindow function sets the window's show state created in a different thread.
UpdateWindow	BOOL UpdateWindow() const; Updates the client area of the window by sending a WM_PAINT message to the window if the window's update region is not empty. If the update region is empty, no message is sent.
ValidateRect	BOOL ValidateRect(LPCRECT prc) const; Validates the client area within a rectangle by removing the rectangle from the update region of the window.
ValidateRgn	BOOL ValidateRgn(CRgn* pRgn) const; Validates the client area within a region by removing the region from the current update region of the window.
WindowFromDC	CWnd* WindowFromDC(CDC* pDC) const; Retrieves a pointer to the window associated with the specified device context. This pointer might be temporary, so don't save it for later use.
WindowFromPoint	static CWnd* WindowFromPoint(POINT pt); Retrieves the window that contains the specified point (in screen coordinates).

Remarks

Refer to the Simple Window section for information on how to use this class to create a window and handle its messages.

Summary Information

Header file	wincore.h
Win32/64 support	Yes
WinCE support	Yes

previous page start next page