DLLSetWindowPos()

DLLSetWindowPos()
  • SYNOPSIS:
    succ = DLLSetWindowPos(hwndHandle,hwndInsertAfter,iNewX,iNewY,iNewW,iNewH,iFlags = 0)
  • DESCRIPTION:
    Sets the position of the specified window. This includes x, y, width, height and depth.
  • PARAMETERS:
    hwndHandle A window handle to the window you want to position.
    hwndInsertAfter

    A window handle that you want to insert your window after. Possible default positioning flags are:

    HWND_BOTTOM - Places the window at the bottom of the Z order. If the hWnd parameter identifies a topmost window, the window loses its topmost status and is placed at the bottom of all other windows.
    HWND_NOTOPMOST - Places the window above all non-topmost windows (that is, behind all topmost windows). This flag has no effect if the window is already a non-topmost window.
    HWND_TOP - Places the window at the top of the Z order.
    HWND_TOPMOST - Places the window above all non-topmost windows. The window maintains its topmost position even when it is deactivated.

    iNewX The new x position you want to move the window to.
    iNewY The new y position you want to move the window to.
    iNewW The new w position you want to move the window to.
    iNewH The new h position you want to move the window to.
    iFlags (optional)

    Additional flags:

    SWP_DRAWFRAME - Draws a frame (defined in the window’s class description) around the window.
    SWP_FRAMECHANGED - Sends a WM_NCCALCSIZE message to the window, even if the window’s size is not being changed. If this flag is not specified, WM_NCCALCSIZE is sent only when the window’s size is being changed.
    SWP_HIDEWINDOW - Hides the window.
    SWP_NOACTIVATE - Does not activate the window. If this flag is not set, the window is activated and moved to the top of either the topmost or non-topmost group (depending on the setting of the hWndInsertAfter parameter).
    SWP_NOCOPYBITS - Discards the entire contents of the client area. If this flag is not specified, the valid contents of the client area are saved and copied back into the client area after the window is sized or repositioned.
    SWP_NOMOVE - Retains the current position (ignores the X and Y parameters).
    SWP_NOOWNERZORDER - Does not change the owner window’s position in the Z order.
    SWP_NOREDRAW - Does not redraw changes. If this flag is set, no repainting of any kind occurs. This applies to the client area, the nonclient area (including the title bar and scroll bars), and any part of the parent window uncovered as a result of the window being moved. When this flag is set, the application must explicitly invalidate or redraw any parts of the window and parent window that need redrawing.
    SWP_NOREPOSITION - Same as the SWP_NOOWNERZORDER flag.
    SWP_NOSENDCHANGING - Prevents the window from receiving the WM_WINDOWPOSCHANGING message.
    SWP_NOSIZE - Retains the current size (ignores the cx and cy parameters).
    SWP_NOZORDER - Retains the current Z order (ignores the hWndInsertAfter parameter).
    SWP_SHOWWINDOW - Displays the window.

  • RETURNS:
    True or False, depending on whether or not the command succeeds in positioning the window referenced.
  • EXAMPLE:
    See example015.bb
  • BUGS:
    None Known.

Return To Index
Problems with this command or bugs? EMail me at: mailto:loki.sd@blueyonder.co.uk

Section Last Updated: Saturday, February 2, 2002 2:05 PM GMT

All materials used in this help, related sources and binaries are (C)opyright Rob Hutchinson, Joseph Cox and Tarropithium Software 2002. All rights reserved. All software is provided without warranty unless otherwise stated.
Tarropithium Software or the authors will not be held liable for any damage or data loss that may occur during the application of this software. Use it at your own risk!