SetWindowPos讲解

SetWindowPos

 

SetWindowPos函数改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。

中文名

SetWindowPos

原    型

BOOL SetWindowPos

功    能

改变一个子窗口，弹出式窗口

参    数

hWnd窗口句柄

目录

1. 1 函数原型
2. 2 函数参数
3. 3 返回值
4. 4 其它相关

1. 5 VB例子
2. 6 VC原型
3. 7 VC功能
4. 8 参数

1. 9 VC例子
2. 10 c#说明
3. 11 其他相关

函数原型

WINUSERAPI  BOOL  WINAPI  SetWindowPos( HWND  hWnd,HWND  hWndInsertAfter,int  X,int  Y,int  cx,_In_  int  cy,  UINT uFlags);

函数参数

hwnd

在z序中的位于被置位的窗口前的 窗口句柄。该参数必须为一个窗口句柄

hWndlnsertAfter

用于标识在z-顺序的此 CWnd 对象之前的 CWnd 对象。或下列值之一：

• HWND_BOTTOM：将窗口置于Z序的底部。如果参数hWnd标识了一个顶层窗口，则窗口失去顶级位置，并且被置在其他窗口的底部。
• HWND_NOTOPMOST：将窗口置于所有非顶层窗口之上（即在所有顶层窗口之后）。如果窗口已经是非顶层窗口则该标志不起作用。
• HWND_TOP:将窗口置于Z序的顶部。
• HWND_TOPMOST:将窗口置于所有非顶层窗口之上。即使窗口未被激活窗口也将保持顶级位置。

查看该参数的使用方法，请看说明部分。

x

以客户坐标指定窗口新位置的左边界。

Y

以客户坐标指定窗口新位置的顶边界。

cx

以像素指定窗口的新的宽度。

cy

以像素指定窗口的新的高度。

uFlags

窗口尺寸和定位的标志。该参数可以是下列值的组合：

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

返回值

如果函数成功，返回值为非零；如果函数失败，返回值为零。若想获得更多错误消息，请调用GetLastError函数。

其它相关

备注：如果设置了SWP_SHOWWINDOW和SWP_HIDEWINDOW标志，则窗口不能被移动和改变大小。如果使用SetWindowLong改变了窗口的某些数据，则必须调用函数SetWindowPos来作真正的改变。使用下列的组合标志：SWP_NOMOVEISWP_NOSIZEISWP_FRAMECHANGED。

有两种方法将窗口设为最顶层窗口：一种是将参数hWndlnsertAfter设置为HWND_TOPMOST并确保没有设置SWP_NOZORDER标志；另一种是设置窗口在Z序中的位置以使其在其他存在的窗口之上。当一个窗口被置为最顶层窗口时，属于它的所有窗口均为最顶层窗口，而它的所有者的z序并不改变。

如果HWND_TOPMOST和HWND_NOTOPMOST标志均未指定，即应用程序要求窗口在激活的同时改变其在Z序中的位置时，在参数hWndinsertAfter中指定的值只有在下列条件中才使用：

在hWndlnsertAfter参数中没有设定HWND_NOTOPMOST和HWND_TOPMOST标志。

由hWnd参数标识的窗口不是激活窗口。

如果未将一个非激活窗口设定到z序的顶端，应用程序不能激活该窗口。应用程序可以无任何限制地改变被激活窗口在Z序中的位置，或激活一个窗口并将其移到最高级窗口的顶部或非最高级窗口的顶部。

如果一个顶层窗口被 重定位到z序的底部（HWND_BOTTOM）或在任何非最高序的窗口之后，该窗口就不再是最顶层窗口。当一个最顶层窗口被置为非最顶级，则它的所有者窗口和所属者窗口均为非最顶层窗口。

一个非最顶端窗口可以拥有一个最顶端窗口，但反之则不可以。任何属于顶层窗口的窗口（例如一个对话框）本身就被置为顶层窗口，以确保所有被属窗口都在它们的所有者之上。

如果应用程序不在前台，但应该位于前台，就应调用SetForegroundWindow函数来设置。

Windows CE：如果这是一个可见的顶层窗口，并且未指定SWP_NOACTIVATE标志，则这个函数将激活窗口、如果这是当前的激活窗口，并且指定了SWP_NOACTIVATE或SWP_HIDEWINDOW标志，则激活另外一个可见的顶层窗口。

当在这个函数中的nFlags参数里指定了SWP_FRAMECHANGED标志时，WindowsCE重画窗口的整个非客户区，这可能会改变客户区的大小。这也是重新计算客户区的唯一途径，也是通过调用SetwindowLong函数改变窗口风格后通常使用的方法。

SetWindowPos将使WM_WINDOWPOSCHANGED消息向窗口发送，在这个消息中传递的标志与传递给函数的相同。这个函数不传递其他消息。

Windows CE 1.0不支持在hWndlnsertAber参数中的HWND_TOPMOST和HWND_NOTOPMOST 常量。

Windows CE1.0不支持在fuFags参数中的SWP_DRAWFRAME和SWP_NOCOPYBITS标志。

速查：Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuser.h库文件：eser32lib。

VB例子

加入本函数的声明Private Declare Function SetWindowPos Lib "user32" Alias "SetWindowPos" (ByVal hwnd As Long, ByVal hWndInsertAfter As Long, ByVal x As Long, ByVal y As Long, ByVal cx As Long, ByVal cy As Long, ByVal wFlags As Long) As Long

新建个控件  Check1

'完整代码如下：

Private Sub Check1_Click()

Dim Q

If Check1.Value = 1 Then

Q = SetWindowPos(Me.hWnd, -1, 0, 0, 0, 0, 3)

Else

Q = SetWindowPos(Me.hWnd, -2, 0, 0, 0, 0, 3)

End If

End Sub

Private Sub Form_Load()

Check1.Caption = "点击窗口置前"

End Sub

VC原型

BOOL SetWindowPos(const CWnd* pWndInsertAfter, int x, int y, int cx, int cy,UINT nFlags);

VC功能

调用这个成员函数以改变子窗口、弹出窗口和顶层窗口的大小、位置和Z轴次序。窗口在屏幕上按照它们的Z轴次序排序。在Z轴次序上处于顶端的窗口将程序在所有其它窗口的顶部。子窗口的所有坐标都是客户坐标（相对于父窗口客户区的左上角）。窗口可以被移动到Z轴次序的顶部，既可以通过将pWndInsertAfter参数设为&wndTopMost，并确保没有设置SWP_NOZORDER标志，也可以通过设置窗口的Z轴次序使它位于所有现存的顶层窗口上方。当一个非顶层窗口被设为顶层窗口时，它拥有的窗口也被设为顶层的。它的拥有者不发生变化。如果顶层窗口被重新定位到Z轴次序的底部（&wndBottom）或任何非顶层窗口之后，则它将不再是顶层窗口。当顶层窗口被变为非顶层窗口时，它所有的拥有者和它拥有的所有窗口都被变为非顶层窗口。

参数

pWndInsertAfter

标识了在Z轴次序上位于这个CWnd对象之前的CWnd对象。这个参数可以是指向CWnd对象的 指针，也可以是指向下列值的指针：

wndBottom 将窗口放在Z轴次序的底部。如果这个CWnd是一个顶层窗口，则窗口将失去它的顶层状态；系统将这个窗口放在其它所有窗口的底部。

wndTop 将窗口放在Z轴次序的顶部。

wndTopMost 将窗口放在所有非顶层窗口的上面。这个窗口将保持它的顶层位置，即使它失去了活动状态。

wndNoTopMost 将窗口重新定位到所有非顶层窗口的顶部（这意味着在所有的顶层窗口之下）。这个标志对那些已经是非顶层窗口的窗口没有作用。有关这个函数以及这些参数的使用规则参见说明部分。

x指定了窗口左边的新位置。

y指定了窗口顶部的新位置。

cx指定了窗口的新宽度。

cy指定了窗口的新高度。

nFlags指定了大小和位置选项。这个参数可以是下列值的组合：

SWP_DRAWFRAME 围绕窗口画出边框（在创建窗口的时候定义）。

SWP_FRAMECHANGED 向窗口发送一条WM_NCCALCSIZE消息，即使窗口的大小不会改变。如果没有指定这个标志，则仅当窗口的大小发生变化时才发送WM_NCCALCSIZE消息。

SWP_HIDEWINDOW 隐藏窗口。

SWP_NOACTIVATE 不激活窗口。如果没有设置这个标志，则窗口将被激活并移动到顶层或非顶层窗口组（依赖于pWndInsertAfter参数的设置）的顶部。

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 保持当前的次序（忽略pWndInsertAfter）。

SWP_SHOWWINDOW 显示窗口。

VC例子

BOOL CDesktopADDlg::OnInitDialog()

{

CDialog::OnInitDialog();

// 设置此对话框的图标。当应用程序主窗口不是对话框时，框架将自动

// 执行此操作

SetIcon(m_hIcon, TRUE); // 设置大图标

SetIcon(m_hIcon, FALSE); // 设置小图标

// TODO: 在此添加额外的初始化代码

int cx = GetSystemMetrics(SM_CXSCREEN);

int cy = GetSystemMetrics(SM_CYSCREEN);

int dx = 600;

int dy = 400;

SetWindowPos(&wndBottom,cx-dx,cy-dy,dx,dy,SWP_NOACTIVATE); //设置广告窗口浮动于右下角

return TRUE; // 除非将焦点设置到控件，否则返回 TRUE

}

c#说明

[DllImport("user32.dll", EntryPoint = "SetWindowPos")]

static extern bool SetWindowPos(

IntPtr hWnd,

IntPtr hWndInsertAfter,

int X,

int Y,

int cx,

int cy,

uint uFlags

);

static readonly IntPtr HWND_TOPMOST = new IntPtr(-1);

static readonly IntPtr HWND_NOTOPMOST = new IntPtr(-2);

static readonly IntPtr HWND_TOP = new IntPtr(0);

const UInt32 SWP_NOSIZE = 0x0001;

const UInt32 SWP_NOMOVE = 0x0002;

const UInt32 SWP_NOZORDER = 0x0004;

const UInt32 SWP_NOREDRAW = 0x0008;

const UInt32 SWP_NOACTIVATE = 0x0010;

const UInt32 SWP_FRAMECHANGED = 0x0020;

const UInt32 SWP_SHOWWINDOW = 0x0040;

const UInt32 SWP_HIDEWINDOW = 0x0080;

const UInt32 SWP_NOCOPYBITS = 0x0100;

const UInt32 SWP_NOOWNERZORDER = 0x0200;

const UInt32 SWP_NOSENDCHANGING = 0x0400;

const UInt32 TOPMOST_FLAGS = SWP_NOMOVE | SWP_NOSIZE;

其他相关

易语言DLL命令使用格式

.DLL命令 API_SetWindowPos, 整数型, "user32", "SetWindowPos", 这个函数能为窗口指定一个新位置和状态。它也可改变窗口在内部窗口列表中的位置。该函数与DeferWindowPos函数相似，只是它的作用是立即表现出来的（在vb里使用：针对vb窗体，如它们在win32下屏蔽或最小化，则需重设最顶部状态。如有必要，请用一个子类处理模块来重设最顶部状态 非零表示成功，零表示失败。会设置GetLastError
　　.参数 hwnd, 整数型, , 欲定位的窗口
　　.参数 hWndInsertAfter, 整数型, , 窗口句柄。在窗口列表中，窗口hwnd会置于这个窗口句柄的后面。也可能选用下述值之一：;HWND_BOTTOM：将窗口置于窗口列表底部;HWND_TOP：将窗口置于Z序列的顶部；Z序列代表在分级结构中，窗口针对一个给定级别的窗口显示的顺序;HWND_TOPMOST：将窗口置于列表顶部，并位于任何最顶部窗口的前面;HWND_NOTOPMOST：将窗口置于列表顶部，并位于任何最顶部窗口的后面
　　.参数 x, 整数型, , 窗口新的x坐标。如hwnd是一个子窗口，则x用父窗口的客户区坐标表示
　　.参数 y, 整数型, , 窗口新的y坐标。如hwnd是一个子窗口，则y用父窗口的客户区坐标表示
　　.参数 cx, 整数型, , 指定新的窗口宽度
　　.参数 cy, 整数型, , 指定新的窗口高度
　　.参数 wFlags, 整数型, , 包含了旗标的一个整数;SWP_DRAWFRAME：围绕窗口画一个框;SWP_HIDEWINDOW：隐藏窗口;SWP_NOACTIVATE：不激活窗口;SWP_NOMOVE：保持当前位置（x和y设定将被忽略）;SWP_NOREDRAW：窗口不自动重画;SWP_NOSIZE：保持当前大小（cx和cy会被忽略）;SWP_NOZORDER：保持窗口在列表的当前位置（hWndInsertAfter将被忽略）;SWP_SHOWWINDOW：显示窗口;SWP_FRAMECHANGED：强迫一条WM_NCCALCSIZE消息进入窗口，即使窗口的大小没有改变;