|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| No
| Platform Notes
| None
|
|
|
BeginDeferWindowPos
The BeginDeferWindowPos function allocates memory for a multiple-window  position structure and returns the handle to the structure.
HDWP BeginDeferWindowPos(
int nNumWindows
| // number of windows
| );
|
|
Parameters
nNumWindows
Specifies the initial number of windows for which to store position
information. The DeferWindowPos function increases the size of the structure, if necessary.
Return Values
If the function succeeds, the return value identifies the multiple-window position structure. If insufficient system resources are available to
allocate the structure, the return value is NULL.
Remarks
The multiple-window position structure is an internal structure; an application cannot access it
directly.
DeferWindowPos fills the multiple-window position structure with information about the target position for one or more
windows about to be moved. The EndDeferWindowPos function accepts the handle to this structure and repositions the windows by
using the information stored in the structure.
If any of the windows in the multiple-window position structure have the SWP_HIDEWINDOW or SWP_SHOWWINDOW flag set, none
of the windows are repositioned.
If Windows must increase the size of the multiple-window position structure beyond the initial size specified by the nNumWindows parameter but cannot allocate enough memory to do so, Windows fails the
entire window positioning sequence (BeginDeferWindowPos, DeferWindowPos, and EndDeferWindowPos). By specifying the maximum size needed, an application can detect and
process failure early in the process.
See Also
DeferWindowPos, EndDeferWindowPos, SetWindowPos
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
