C#中SetWindowPos函数详解

[DllImport("user32.dll")]
        private static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndlnsertAfter, int X, int Y, int cx, int cy, uint Flags);

SetWindowPos(
hWnd: HWND; {窗口句柄}
hWndInsertAfter: HWND; {窗口的 Z 顺序}
X, Y: Integer; {位置}
cx, cy: Integer; {大小}
uFlags: UINT {选项}
): BOOL;
//hWndInsertAfter 参数可选值:
HWND_TOP = ; {在前面}
HWND_BOTTOM = ; {在后面}
HWND_TOPMOST = HWND(-); {在前面, 位于任何顶部窗口的前面}
HWND_NOTOPMOST = HWND(-); {在前面, 位于其他顶部窗口的后面}
//uFlags 参数可选值:
SWP_NOSIZE = ; {忽略 cx、cy, 保持大小}
SWP_NOMOVE = ; {忽略 X、Y, 不改变位置}
SWP_NOZORDER = ; {忽略 hWndInsertAfter, 保持 Z 顺序}
SWP_NOREDRAW = ; {不重绘}
SWP_NOACTIVATE = $; {不激活}
SWP_FRAMECHANGED = $; {强制发送 WM_NCCALCSIZE 消息, 一般只是在改变大小时才发送此消息}
SWP_SHOWWINDOW = $; {显示窗口}
SWP_HIDEWINDOW = $; {隐藏窗口}
SWP_NOCOPYBITS = $; {丢弃客户区}
SWP_NOOWNERZORDER = $; {忽略 hWndInsertAfter, 不改变 Z 序列的所有者}
SWP_NOSENDCHANGING = $; {不发出 WM_WINDOWPOSCHANGING 消息}
SWP_DRAWFRAME = SWP_FRAMECHANGED; {画边框}
SWP_NOREPOSITION = SWP_NOOWNERZORDER;{}
SWP_DEFERERASE = $; {防止产生 WM_SYNCPAINT 消息}
SWP_ASYNCWINDOWPOS = $; {若调用进程不拥有窗口, 系统会向拥有窗口的线程发出需求}

-----------------------------------------------------------------------

WinAPI: SetWindowPos - 改变窗口的位置与状态

SetWindowPos(
hWnd: HWND; {窗口句柄}
hWndInsertAfter: HWND; {窗口的 Z 顺序}
X, Y: Integer; {位置}
cx, cy: Integer; {大小}
uFlags: UINT {选项}
): BOOL;

//hWndInsertAfter 参数可选值:
HWND_TOP = ; {在前面}
HWND_BOTTOM = ; {在后面}
HWND_TOPMOST = HWND(-); {在前面, 位于任何顶部窗口的前面}
HWND_NOTOPMOST = HWND(-); {在前面, 位于其他顶部窗口的后面}

//uFlags 参数可选值:
SWP_NOSIZE = ; {忽略 cx、cy, 保持大小}
SWP_NOMOVE = ; {忽略 X、Y, 不改变位置}
SWP_NOZORDER = ; {忽略 hWndInsertAfter, 保持 Z 顺序}
SWP_NOREDRAW = ; {不重绘}
SWP_NOACTIVATE = $; {不激活}
SWP_FRAMECHANGED = $; {强制发送 WM_NCCALCSIZE 消息, 一般只是在改变大小时才发送此消息}
SWP_SHOWWINDOW = $; {显示窗口}
SWP_HIDEWINDOW = $; {隐藏窗口}

--------------------------------------------------------------------------------------

SetWindowPos（）
函数功能：该函数改变一个子窗口，弹出式窗口式顶层窗口的尺寸，位置和Z序。子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。
函数原型：BOOL SetWindowPos（HWN hWnd，HWND hWndlnsertAfter,int X，int Y,int cx，int cy,UNIT．Flags）；
参数：
hWnd:窗口句柄。
hWndlnsertAfter:在z序中的位于被置位的窗口前的窗口句柄。该参数必须为一个窗口句柄，或下列值之一：
HWND_BOTTOM：将窗口置于Z序的底部。如果参数hWnd标识了一个顶层窗口，则窗口失去顶级位置，并且被置在其他窗口的底部。
HWND_DOTTOPMOST：将窗口置于所有非顶层窗口之上（即在所有顶层窗口之后）。如果窗口已经是非顶层窗口则该标志不起作用。
HWND_TOP:将窗口置于Z序的顶部。
HWND_TOPMOST:将窗口置于所有非顶层窗口之上。即使窗口未被激活窗口也将保持顶级位置。

查看该参数的使用方法，请看说明部分。
x：以客户坐标指定窗口新位置的左边界。
Y：以客户坐标指定窗口新位置的顶边界。
cx:以像素指定窗口的新的宽度。
cy：以像素指定窗口的新的高度。

uFlags:窗口尺寸和定位的标志。该参数可以是下列值的组合：
SWP_ASNCWINDOWPOS：如果调用进程不拥有窗口，系统会向拥有窗口的线程发出需求。这就防止调用线程在其他线程处理需求的时候发生死锁。
SWP_DEFERERASE：防止产生WM_SYNCPAINT消息。
SWP_DRAWFRAME：在窗口周围画一个边框（定义在窗口类描述中）。
SWP_FRAMECHANGED：给窗口发送WM_NCCALCSIZE消息，即使窗口尺寸没有改变也会发送该消息。如果未指定这个标志，只有在改变了窗口尺寸时才发送WM_NCCALCSIZE。
SWP_HIDEWINDOW;隐藏窗口。
SWP_NOACTIVATE：不激活窗口。如果未设置标志，则窗口被激活，并被设置到其他最高级窗口或非最高级组的顶部（根据参数hWndlnsertAfter设置）。
SWP_NOCOPYBITS：清除客户区的所有内容。如果未设置该标志，客户区的有效内容被保存并且在窗口尺寸更新和重定位后拷贝回客户区。
SWP_NOMOVE：维持当前位置（忽略X和Y参数）。
SWP_NOOWNERZORDER：不改变z序中的所有者窗口的位置。
SWP_NOREDRAW: 不重画改变的内容。如果设置了这个标志，则不发生任何重画动作。适用于客户区和非客户区（包括标题栏和滚动条）和任何由于窗回移动而露出的父窗口的所有部分。如果设置了这个标志，应用程序必须明确地使窗口无效并区重画窗口的任何部分和父窗口需要重画的部分。
SWP_NOREPOSITION；与SWP_NOOWNERZORDER标志相同。
SWP_NOSENDCHANGING：防止窗口接收WM_WINDOWPOSCHANGING消息。
SWP_NOSIZE：维持当前尺寸（忽略cx和Cy参数）。
SWP_NOZORDER：维持当前Z序（忽略hWndlnsertAfter参数）。
SWP_SHOWWINDOW：显示窗口。

返回值：如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误消息，请调用GetLastError函数。
备注：如果设置了SWP_SHOWWINDOW和SWP_HIDEWINDOW标志，则窗口不能被移动和改变大小。如果使用SetWindowLoog改变了窗口的某些数据，则必须调用函数SetWindowPos来作真正的改变。使用下列的组合标志：SWP_NOMOVEISWP_NOSIZEISWP_FRAMECHANGED。
有两种方法将窗口设为最顶层窗口：一种是将参数hWndlnsertAfter设置为HWND_TOPMOST并确保没有设置SWP_NOZORDER标志；另一种是设置窗口在Z序中的位置以使其在其他存在的窗口之上。当一个窗口被置为最顶层窗口时

DWORD_PRT SetWindowPos(HWND hWnd,HWND hInsertAfter,int x,int y,int cx,int cy,UINT nFlag)

SetWindowPos函数功能是将一个窗口在三维空间中移动，利用它，你可以改变一个窗口的位置，甚至可以在Z轴上改变（Z轴决定了一个窗口和其它窗口的前后关系），你还可以改变窗口的尺寸。为了实现TopMost类型的窗口，我们只需调用该函数，将窗口放在所有窗口的前面并永远保持在最前面即可

表1 SetWindowPos函数的参数解释
参数名 参数含义
hwnd 要移动的窗口的句柄（可以用窗体的hwnd属性）
hWndInsertAfter 关于如何在Z轴上放置窗口的标记（具体见表2）
x 相当于窗口的Left属性
y 相当于窗口的Top属性
cx 相当于窗口的Right属性
cy 相当于窗口的Bottom属性
wFlags 关于如何移动窗口的标记（具体见表3）
表2 HWndInsertAfter参数的可能取值及含义
hWndInsertAfter的可能取值 功能
某一窗口的句柄 将窗口放在该句柄指定的窗口后面
HWND_BOTTOM() 把窗口放在Z轴的最后，即所有窗口的后面
HWND_TOP() 将窗口放在Z轴的前面，即所有窗口的前面
HWND_TOPMOST(-) 使窗口成为“TopMost”类型的窗口，这种类型
的窗口总是在其它窗口的前面，真到它被关闭
HWND_NOTOPMOST(-) 将窗口放在所有“TopMost”类型
窗口的后面、其它类型窗口的前面
表3 wFlags参数的可能值及含义
wFlags参数的可能值 功能
SWP_DRAWFRAME(&H20) 移动窗口后重画窗口及其上的所有内容
SWP_HIDEWINDOW(&H80) 隐藏窗口，窗口隐藏后既不出现在屏幕上也不出现在任
务栏上，但它仍然处于激活状态
SWP_NOACTIVATE(&H10) 窗口移动后不激活窗口，当然，如果窗口在移动前就是
激活的则例外
SWP_NOCOPYBITS(&H100) 当窗口移动后，不重画它上面的任何内容
SWP_NOMOVE(&H2) 不移动窗口（即忽略X和Y参数）
SWP_NOSIZE(&H1) 不改变窗口尺寸（即忽略Cx和Cy参数）
SWP_NOREDRAW(&H8) Do not remove the image of the window in its former position
from the screen. In other words,leave behind a ghost image
of the window in its old position
SWP_NOZORDER(&H4) 不改变窗口听Z轴位置（即忽略hWndInsertAfter参数）
SWP_SHOWWINDOW(&H40) 显示窗口（之前必须使用过SWP_HIDEWINDOW
隐藏窗口）

注释：

假如指定了SWP_SHOWWINDOW或SWP_HIDEWINDOW,窗口不能被移动或改变大小。
子窗口的所有坐标都是客户区坐标(相对于父窗口的客户区左上角).
一个窗口能够成为一个Topmost窗口，可以通过设置hWndInsertAfter参数为HWND_TOPMOST并且保证SWP_NOZORDER标志没有设置,或者通过设置它的窗口在Z轴方向上的位置，以便使它在现存的任何Topmost窗口之上.当一个非Topmost窗口被设置成topmost,那么它拥有的窗口也将成为，然而它的拥有者们没有变。

假如SWP_NOACTIVATE和SWP_NOZORDER标志都没有指定(指当应用程序要求窗口被激活同时改变它在Z轴方向上的位置时),则hWndInsertAfter仅用在以下几种情况:
.HWND_TOPMOST和HWND_NOTOPMOST标志在hWndInsertAfter中都没有指定.
.hWnd句柄指定的窗口不是活动窗口.

如果一个应用程序不把一个非活动窗口调整到Z轴方向顶部，则不能激活非活动窗口。应用程序能够没有限制地改变一个活动窗口在Z轴方向上的位置,它能够激活一个窗口并且把它移动到topmost或者非topmost窗口的顶部。
假如一个topmost窗口被重定位到Z轴方向上最下面(HWND_BOTTOM)，或者在任何非topmost窗口后面,那么它不在是topmost窗口.当一个Topmost窗口变成非topmost窗口时,它的拥有者和它拥有的窗口也都将成为非topmost窗口.

一个非Topmost窗口能够拥有一个Topmost窗口,但是反过来不行.任何窗口(例如：一个对话框）被一个Topmost窗口拥有，同时它使也自己成为一个Topmost窗口,要保证所有被拥有的窗口处在它们的拥有者的上面。
假如一个应用程序没有在前台，但是要成为前台程序,它应该调用SetForegroundWindow函数.

参看：
MoveWindow, SetActiveWindow, SetForegroundWindow

头文件: 在Winuser.h中定义。
静态库: User32.lib.

示例代码：
移动到屏幕的左上角：
　　　　SetWindowPos(m_hWnd,NULL,,,,,SWP_NOSIZE);
使其成为Topmost窗口并移动到屏幕的左上角：
SetWindowPos(m_hWnd,HWND_TOPMOST,,,,,SWP_NOSIZE)；
显示窗口：
SetWindowPos(m_hWnd,NULL,,,,,SWP_SHOWWINDOW|SWP_NOSIZE|SWP_NOMOVE)；
隐藏窗口：
SetWindowPos(m_hWnd,NULL,,,,,SWP_HIDEWINDOW|SWP_NOSIZE|SWP_NOMOVE)；
改变窗口大小：
CRect newRect;
::GetWindowRect(m_hWnd,&newRect);
::SetWindowPos(m_hWnd,NULL,,,newRect.Width()/,newRect.Height()/,SWP_NOMOVE);
SWP_NOCOPYBITS = $; {丢弃客户区}
SWP_NOOWNERZORDER = $; {忽略 hWndInsertAfter, 不改变 Z 序列的所有者}
SWP_NOSENDCHANGING = $; {不发出 WM_WINDOWPOSCHANGING 消息}
SWP_DRAWFRAME = SWP_FRAMECHANGED; {画边框}
SWP_NOREPOSITION = SWP_NOOWNERZORDER;{}
SWP_DEFERERASE = $; {防止产生 WM_SYNCPAINT 消息}
SWP_ASYNCWINDOWPOS = $; {若调用进程不拥有窗口, 系统会向拥有窗口的线程发出需求}