2024年3月24日发(作者：)

置顶窗口SetWindowPos()的用法

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(1) 把窗口放在Z轴的最后，即所有窗口的后面

HWND_TOP(0) 将窗口放在Z轴的前面，即所有窗口的前面

HWND_TOPMOST(-1) 使窗口成为“TopMost”类型的窗口，这种类

型

的窗口总是在其它窗口的前面，真到它被关闭

HWND_NOTOPMOST(-2) 将窗口放在所有“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仅用在以下几种情况:

_TOPMOST和HWND_NOTOPMOST标志在hWndInsertAfter中都没有

指定.

句柄指定的窗口不是活动窗口. 如果一个应用程序不把一个非活动窗口调整

到Z轴方向顶部，则不能激活非活动窗口。应用程序能够没有限制地改变一个活动窗口在

Z轴方向上的位置,它能够激活一个窗口并且把它移动到topmost或者非topmost窗口的

顶部。

假如一个topmost窗口被重定位到Z轴方向上最下面(HWND_BOTTOM)，或者在任

何非topmost窗口后面,那么它不在是topmost窗口.当一个Topmost窗口变成非

topmost窗口时,它的拥有者和它拥有的窗口也都将成为非topmost窗口. 一个非

Topmost窗口能够拥有一个Topmost窗口,但是反过来不行.任何窗口(例如：一个对话框）

被一个Topmost窗口拥有，同时它使也自己成为一个Topmost窗口,要保证所有被拥有的

窗口处在它们的拥有者的上面。

假如一个应用程序没有在前台，但是要成为前台程序,它应该调用

SetForegroundWindow函数. 参看：

MoveWindow, SetActiveWindow, SetForegroundWindow 使用条件:

Windows NT：可以。

Windows 95：可以。

Win32s: 可以。

头文件: 在Winuser.h中定义。

静态库: . 示例代码：

移动到屏幕的左上角：

SetWindowPos(m_hWnd,NULL,0,0,0,0,SWP_NOSIZE);

使其成为Topmost窗口并移动到屏幕的左上角：

SetWindowPos(m_hWnd,HWND_TOPMOST,0,0,0,0,SWP_NOSIZE)；

显示窗口：

SetWindowPos(m_hWnd,NULL,0,0,0,0,SWP_SHOWWINDOW|SWP_NOSIZE|SWP_N

OMOVE)；

隐藏窗口：

SetWindowPos(m_hWnd,NULL,0,0,0,0,SWP_HIDEWINDOW|SWP_NOSIZE|SWP_NO

MOVE)；

改变窗口大小：

CRect newRect;

::GetWindowRect(m_hWnd,&newRect);

::SetWindowPos(m_hWnd,NULL,0,0,()/2,()/2,SW

P_NOMOVE);