[翻译]-WinCE 程序设计 (3rd 版)--4.2 窗口管理函数

窗口管理函数
了解了Windows以窗口为中心的本质，当您可以从众多用于窗口的函数中进行选择时也就不足为怪了。这些函数允许窗口查询自己的环境，判断自己在窗口家族里的位置。要找到自己的父窗口，窗口可以调用GetParent(HWND hWnd)，该函数接收一个窗口句柄，返回调用该函数的窗口的父窗口句柄。如果这个窗口没有父窗口，则函数返回NULL。

枚举窗口
GetWindow函数是一个多用途函数，它允许窗口来查询其子窗口、拥有者和兄弟窗口。
函数原型如下：HWND GetWindow(HWND hWnd, UINT uCmd);
第一个参数是查询窗口的句柄，第二个参数是一个常量，指出要查询的关系。常量GW_CHILD，表示返回窗口第一个子窗口的句柄。GetWindow是按Z坐标顺序来返回窗口的，所以在这种情况下，第一个子窗口就是Z坐标最高的子窗口。如果窗口没有子窗口，该函数则返回NULL。常量GW_HWNDFIRST和GW_HWNDLAST，按Z坐标返回第一个和最后一个窗口。如果传入的窗口句柄是顶层窗口（顶层窗口是指没有父窗口或父窗口是桌面窗口的窗口），这些常量按Z坐标返回第一个和最后一个最顶层（topmost）窗口。如果传入的窗口句柄是子窗口，GetWindow返回第一个和最后一个兄弟窗口。常量GW_HWNDNEXT和GW_HWNDPREV按Z坐标返回下一个更低和更高的窗口。这些常量允许窗口获得下一个窗口，并用获得的窗口的句柄调用GetWindow来获得下一个窗口，依次类推，最终递归遍历所有的兄弟窗口。常量GW_OWNER则返回窗口拥有者的句柄。

另外一种遍历窗口的方法是EnumWindows函数，其原型如下：
BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam);
参数lpEnumFunc指向一个回调函数，EnumWindows为桌面上的每个顶层窗口调用一次该回调函数，并依次传入每个窗口的句柄。lParam的值是应用程序定义的值，并被传递给枚举函数。该函数比通过GetWindow循环来寻找顶层窗口的遍历方式要好，因为该函数始终返回有效的窗口句柄，而一个GetWindow遍历循环里，获得的窗口句柄可能在下次调用GetWindow之前其对应的窗口就已经被销毁了。但是，因为EnumWindows只对顶层窗口有效，所以当遍历一系列子窗口时GetWindow还是有用武之地的。

查找窗口
要获得一个指定窗口的句柄，可以用函数FindWindow，其原型如下：HWND FindWindow(LPCTSTR lpClassName, LPCTSTR lpWindowName)。
该函数可以通过窗口的类名或者窗口的标题找到窗口。当应用程序刚启动的时候，可以用它来判断是否有程序的另一个副本正在运行，而应用程序所要做的只是用程序主窗口的窗口类名来调用FindWindow就可以了。因为在运行时应用程序几乎总是有一个主窗口的，所以当FindWindow返回NULL，就表示函数用指定的窗口类没找到另外一个窗口，由此几乎可以肯定没有另一个副本在运行。

要查找桌面窗口（desktop window）的句柄，可以使用下面的函数：HWND GetDesktopWindow(void);

编辑窗口结构的内容
函数对GetWindowLong和SetWindowLong允许程序编辑窗口结构中的数据。这两个函数原型如下：
LONG GetWindowLong(HWND hWnd, int nIndex);
LONG SetWindowLong(HWND hWnd, int nIndex, LONG dwNewLong);

一起回忆一下传给RegisterClass函数的WNDCLASS结构吧，它有一个cbWndExtra域，用来控制分配给该结构额外字节数。如果在窗口类注册时您为窗口结构分配了额外的空间，那么您可以用GetWindowLong和SetWindowLong函数来访问这些字节。在Windows CE下，该项必须按4字节为单位来分配和引用。所以如果窗口类在注册时用12填充了cbWndExtra域，那么程序可以使用窗口句柄，通过GetWindowLong或SetWindowLong函数来访问，并且可以将nIndex参数设置为0、4和8。

GetWindowLong和SetWindowLong支持一个预定义的索引值集合，用来使应用程序访问窗口的一些基本参数。下面是Windows CE支持的索引值列表。
GWL_STYLE 窗口风格标志
GWL_EXSTYLE窗口扩展风格标志
GWL_WNDPROC指向窗口过程的指针
GWL_ID窗口标识
GWL_USERDATA应用程序使用的32位值

对话框窗口还支持下面附加的值：
DWL_DLGPROC 指向对话框窗口过程的指针
DWL_MSGRESULT 当对话框函数返回时的返回值
DWL_USER 应用程序使用的32位值

Windows CE不支持GWL_HINSTANCE和GWL_HWNDPARENT值，这些值在Windows 2000和Windows XP下是支持的。

改变风格标志
编辑窗口结构在很多方面是很有用的。在窗口被创建后，通过改变其窗口风格位，可以改变窗口的默认行为和外观。例如，通过切换WS_CAPTION风格位，可以显示或隐藏窗口的标题栏。任何修改窗口外观的风格标志被改变后，习惯上都要通过调用SetWindowPos来强制系统重新绘制窗口的非客户区。

SetWindowPos是Windows中始终使用的函数之一。它允许应用程序移动窗口、改变窗口大小、变换窗口Z坐标，并且在前面提到的情况下，它会重新绘制窗口的非客户区。它的函数原型如下：
BOOL SetWindowPos(HWND hWnd, HWND hWndInsertAfter, int X, int Y, int cx, int cy, UINT uFlags);
第一个参数是即将改变的窗口的句柄。可选参数hWndInsertAfter允许设置窗口的Z坐标。该参数要么是窗口句柄，要么是下面4个标志之一，用来放置窗口到Z坐标顶部或底部。标志位如下所示：
HWND_BOTTOM 窗口在桌面上所有窗口之下。
HWND_TOP窗口在所有窗口的顶部
HWND_TOPMOST 窗口始终放置在其它窗口顶部，即使该窗口处于非活动窗口。
HWND_NOTTOPMOST 窗口位于其它非置顶窗口(nontopmost windows)之上，但没有标记为置顶窗口（topmost window），这样当有另一个窗口成为活动窗口时，该窗口可以被覆盖。

可选的X、Y、cx和cy参数指定了窗口的位置和大小。标志位参数uFlags包含一个或多个标志位，用来描述要完成的任务。这些标志如下所示：
SWP_NOMOVE 不移动窗口
SWP_NOSIZE 不改变窗口大小
SWP_NOZORDER 不设置窗口Z坐标
SWP_NOACTIVATE 如果设置了Z坐标，则不激活窗口
SWP_DRAWFRAME 重绘非客户区
SWP_FRAMECHANGED 重新计算非客户区，并重新绘制。
另有两个标志，SWP_SHOWWINDOW和SWP_HIDEWINDOW，可以显示和隐藏窗口，但调用ShowWindow函数来显示和隐藏窗口会更容易一些。在风格位改变后，要用SetWindowPos来强制重绘框架的话，可以如下操作：
SetWindowPos (hWnd, 0, 0, 0, 0, SWP_NOMOVE|SWP_NOSIZE|SWP_NOZORDER|SWP_FRAMECHANGED);

窗口子类化
SetWindowLong的另一个用途是子类化一个窗口。本质上讲，窗口子类化是使应用程序从先前存在的窗口类派生出新窗口类的一个实例。子类化的典型应用是修改窗口控件的行为，例如一个Edit控件。

子类化的过程实际上是很简单的。先创建一个窗口过程来为被子类化的窗口提供新功能，再用基础窗口类创建一个窗口。然后为该窗口调用GetWindowLong来获得并保存一个指向其初始窗口过程的指针，之后调用SetWindowLong函数，将窗口实例的窗口过程设置成新的窗口过程。这样，新的窗口过程就开始接收发给该窗口的消息了。任何没有被新窗口过程响应的消息都通过调用CallWindowProc传递给到旧的窗口过程。下面的代码展示了窗口创建及被子类化的过程。子类化窗口过程截获了WM_LBUTTONDOWN消息，并且在窗口收到该消息时使扬声器发出声音。
// Prototype of subclass procedure
LRESULT CALLBACK SCWndProc(HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam);

// Variable that holds the pointer to the original WndProc
WNDPROC lpfnOldProc = 0;
//
// Routine that subclasses the requested window.
//
BOOL SubClassThisWnd (HWND hwndSC) {

if (lpfnOldProc == 0) {
// Get and save the pointer to the original window procedure
lpfnOldProc = (WNDPROC)GetWindowLong (hwndSC, GWL_WNDPROC);

// Point to new window procedure
return SetWindowLong (hwndSC, GWL_WNDPROC, (DWORD)SCWndProc);
}
return FALSE;
}
//
// Subclass procedure
//
LRESULT CALLBACK SCWndProc(HWND hWnd, UINT wMsg, WPARAM wParam,
LPARAM lParam) {
switch (wMsg) {

case WM_LBUTTONDOWN:
MessageBeep(0);
break;
}
return CallWindowProc (lpfnOldProc, hWnd, wMsg, wParam, lParam);
}

要去除窗口的子类化，只要调用SetWindowLong，把WndProc指针设置回最初的窗口过程即可。