The WM_NCCALCSIZE message is sent when the size and position of a window’s client area must be calculated. By processing this message, an application can control the content of the window’s client area when the size or position of the window changes.
WM_NCCALCSIZE fCalcValidRects = (BOOL) wParam; // valid area flag lpncsp = (LPNCCALCSIZE_PARAMS) lParam; // points to size calculation data or lpncsp = (LPRECT) lParam; // points to new window coordinates
If this parameter is FALSE, the application does not need to indicate the
valid part of the client area. Also, if this parameter is FALSE, lParam
points to a RECT structure.
If wParam is TRUE, lParam points to an NCCALCSIZE_PARAMS structure that contains information an application can use to calculate the new size and position of the client rectangle.
If the fCalcValidRects parameter is FALSE, the application should return zero.
If fCalcValidRects is TRUE, the application can return zero or a valid combination of the following values:
Value |
Meaning |
WVR_ALIGNTOP, WVR_ALIGNLEFT, WVR_ALIGNBOTTOM, WVR_ALIGNRIGHT | |
These values, used in combination, specify that the client area of the window is to be preserved and aligned appropriately relative to the new position of the window. For example, to align the client area to the lower-left corner, return the WVR_ALIGNLEFT and WVR_ALIGNTOP values. | |
WVR_HREDRAW, WVR_VREDRAW | |
These values, used in combination with any other values, cause the window to be completely redrawn if the client rectangle changes size horizontally or vertically. These values are similar to the CS_HREDRAW and CS_VREDRAW class styles. | |
WVR_REDRAW | |
This value causes the entire window to be redrawn. It is a combination of WVR_HREDRAW and WVR_VREDRAW values. | |
WVR_VALIDRECTS | |
This value indicates that, upon return from WM_NCCALCSIZE, the rectangles specified by the rgrc[1] and rgrc[2] members of the NCCALCSIZE_PARAMS structure contain valid source and destination area rectangles, respectively. Windows combines these rectangles to calculate the area of the window to be preserved. Windows copies any part of the window image that is within the source rectangle and clips the image to the destination rectangle. Both rectangles are in parent-relative or screen-relative coordinates. | |
This return value allows an application to implement more elaborate client-area preservation strategies, such as centering or preserving a subset of the client area. |
If fCalcValidRects is TRUE and an application returns zero, the old client area is preserved and is aligned with the upper-left corner of the new client area.
The window may be redrawn, depending on whether the CS_HREDRAW or CS_VREDRAW class style is specified. This is the default, backward-compatible processing of this message by the DefWindowProc function (in addition to the usual client rectangle calculation described in the preceding table).
DefWindowProc, MoveWindow, SetWindowPos, NCCALCSIZE_PARAMS, RECT
file: /Techref/os/win/api/win32/mess/src/msg26_2.htm, 6KB, , updated: 2000/4/7 12:20, local time: 2024/9/1 10:00,
18.217.26.216:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://piclist.com/techref/os/win/api/win32/mess/src/msg26_2.htm"> WM_NCCALCSIZE</A> |
Did you find what you needed? |
![]() o List host: MIT, Site host massmind.org, Top posters @none found - Page Editors: James Newton, David Cary, and YOU! * Roman Black of Black Robotics donates from sales of Linistep stepper controller kits. * Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters. * Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated! * Contributors: Richard Seriani, Sr. |
Welcome to piclist.com! |
.