Windows 7程序开发系列之一(任务栏篇)
Windows 7 引入了很多新特性，其中最直观的莫过于用户界面上的变化。很多人也因为不能适应这种变化而回到了XP。但是在我看来这些新的特性却是一种进步，使用了一段时间之后，也萌生了要做一点开发的冲动。于是把以前一个电源管理的小软件重写了一次(点此下载 )，利用了Windows 7 的任务栏特性和JumpList。
关于Windows 7开发的中文资料比较少。微软官方的教程还比较丰富，但都是英文的，可能某些英文不太好的朋友学起来比较吃力。我把任务栏和JumpList这两个方面做一个简短的教程，希望对后来者有所帮助。
任务栏方面的东西比JumpList稍微简单一点，就先从任务栏说起。Windows7的任务栏包含了几个新的特性：Progress Bar（进度条）、Overlay Icon(覆盖图标)、 Thumbnail（缩略图）、Thumbnail Toolbar（位于缩略图下方的工具栏）、Tooltip（鼠标指向时的提示信息）、Aero Peek Preview（当鼠标停放在缩略图上时显示窗口预览）。下面是一张foobar2000运行时的截图：
上图中foobar2000使用Progress Bar显示当前歌曲的播放进度，并且在右下角有一个白色的小三角形（Overlay Icon）显示当前是播放还是暂停，使用Thumbnail显示唱片封面，Thumbnail Toolbar有三个按钮分别是上一曲、暂停、下一曲，上方的Tooltip提示当前播放曲目，当鼠标放在缩略图上时，Aero Peek功能会隐藏所有窗口，只显示当前窗口的预览图。上面的Progress Bar和Overlay Icon不太清晰，下面的比较清晰:
这篇文章中，将会讲解这些功能的开发。
MSDN上很容易找到SDK的下载地址，我就不贴了。SDK有1.44G，下载需要一点时间。安装过程也没什么可讲，就是安装完后在开始菜单中找到Microsoft Windows SDK v7.0->Visual Studio Registration->Windows SDK Configuration Tool，将v7.0设置为当前版本，这样VS中的Windows SDK将使用v7.0版。 与任务栏按钮相关的功能都在这个接口中，Progress Bar, Overlay Icon等。首先创建一个Win32项目，并创建一个简单的窗口，具体不再赘述，文章末尾会给出代码。在WinMain函数的开头，注册一个"TaskbarButtonCreated"的消息，
//注册用户消息
WM_TASKBARBUTTONCREATED=::RegisterWindowMessage (TEXT ("TaskbarButtonCreated" ));
这样我们在WndProc中就可以收到我们注册的 WM_TASKBARBUTTONCREATED消息了。在这个消息中，创建ITaskbarList4 接口对象，并调用初始化方法。至于COM相关的内容，已经超出了本教程的范围，有兴趣的可以参考相关资料。
//创建接口对象 ITaskbarList
if (msg==WM_TASKBARBUTTONCREATED )
{
::CoCreateInstance (CLSID_TaskbarList,NULL,CLSCTX_INPROC_SERVER,IID_PPV_ARGS (&g_pTaskbar ));
g_pTaskbar->HrInit ();
} SetProgressState 方法设置进度条的状态，实际反映出来就是进度条的颜色，它接受一个窗口句柄和一个状态标记为参数。其中 TBPF_NOPROGRESS 为取消进度条，TBPF_INDETERMINATE 是一个不断滚动的，无确定值的进度条。
SetProgressValue 方法设置进度条的值，也就是当前进度。它的参数是窗口句柄、当前值和总值。如果用这个方法设置了进度条，之前设置的TBPF_INDETERMINATE 将无效。
SetOverlayIcon 设置覆盖图标，他的参数是窗口句柄、图标句柄和描述。其中图标要求16X16大小。如果图标句柄为NULL，则取消覆盖图标。
在g_pTaskbar对象初始化后，加入下面代码：
g_pTaskbar->SetProgressState (g_hWnd,TBPF_ERROR );
g_pTaskbar->SetProgressValue (g_hWnd,50,100 );
g_pTaskbar->SetOverlayIcon (g_hWnd,g_hRed,TEXT ("Error" ));
这段代码将进度条状态设置为ERROR（红色），进度为50%，并在右下角显示一个红色图标（图标已在WinMain函数中加载）。运行后效果如下：
Toolbar稍微麻烦一点，需要设置一个结构THUMBBUTTON 。其中参数dwMask 是一些标记的组合，这里我们设置为THB_ICON | THB_TOOLTIP ，即我们会使用icon和tooltip这两个字段（注意此处的tooltip是按钮的tooltip，不要与上面的tooltip混淆了）。iId 关系到事件的响应，可按顺序编号。hIcon 是该按钮使用的图标句柄。szTip 中设置提示信息。使用下面的代码增加3个按钮：
THUMBBUTTONMASKdwMask=THB_ICON | THB_TOOLTIP ;
THUMBBUTTONthbButtons[3];
thbButtons[0].dwMask=dwMask ;
thbButtons[0].iId=0 ;
thbButtons[0].hIcon=g_hRed ;
StringCbCopy (thbButtons[0].szTip,sizeof (thbButtons[0].szTip),TEXT ("Red" ));
thbButtons[1].dwMask=dwMask ;
thbButtons[1].iId=1 ;
thbButtons[1].hIcon=g_hGreen ;
StringCbCopy (thbButtons[1].szTip,sizeof (thbButtons[1].szTip),TEXT ("Green" ));
thbButtons[2].dwMask=dwMask ;
thbButtons[2].iId=2 ;
thbButtons[2].hIcon=g_hBlue ;
StringCbCopy (thbButtons[2].szTip,sizeof (thbButtons[2].szTip),TEXT ("Blue" ));
g_pTaskbar->ThumbBarAddButtons (g_hWnd,ARRAYSIZE (thbButtons),thbButtons );
效果如下:
按钮有了，该响应这些按钮的消息了。点击这些按钮后，windows将会发送一个WM_COMMAND 消息，其中wParam 的高位为THBN_CLICKED ，低位是按钮的id（由参数iId设置 ）。
caseWM_COMMAND:
if (HIWORD (wParam ) ==THBN_CLICKED )
{
OnThumbnailButtonClicked (LOWORD (wParam ));
}
break ;
voidOnThumbnailButtonClicked ( intid )
{
switch (id )
{
case0:
SetForegroundWindow (g_hWnd );
MessageBox (g_hWnd,TEXT ("Red button clicked!"),NULL,MB_OK );
break ;
case1:
SetForegroundWindow (g_hWnd );
MessageBox (g_hWnd,TEXT ("Green button clicked!"),NULL,MB_OK );
break ;
case2:
SetForegroundWindow (g_hWnd );
MessageBox (g_hWnd,TEXT ("Blue button clicked!"),NULL,MB_OK );
break ;
}
}
现在点击工具栏上的按钮将会有显示对应的消息框。
Tooltip比较简单。SetThumbnailTooltip 传入窗口句柄和描述的文字就可以了。在 WM_TASKBARBUTTONCREATED 消息处理中加入下面代码：
g_pTaskbar->SetThumbnailTooltip (g_hWnd,TEXT ("Some information" ));
信息提示显示在预览窗之上：
到目前为止，这个程序的缩略图和Aero Peek预览仍然是由系统来控制。对于大多数程序来说，系统自动产生的缩略图和预览几经足够。但有时候我们想要自己控制，比如foobar2000需要在缩略图中显示唱片封面（见第一张图）。
要实现手动控制，需要在窗口创建以后设置一下窗口的属性，告诉Windows该窗口的缩略图和预览图需要由程序提供。在窗口创建之后加入下面代码：
//设置窗口属性，打开自定义缩 略图和AeroPeek预览
BOOLtruth=TRUE ;
DwmSetWindowAttribute (g_hWnd,DWMWA_HAS_ICONIC_BITMAP,&truth,sizeof (truth ));
DwmSetWindowAttribute (g_hWnd,DWMWA_FORCE_ICONIC_REPRESENTATION,&truth,sizeof (truth ));
通过这样的设置以后，在WndProc中就可以收到WM_DWMSENDICONICTHUMBNAIL 和WM_DWMSENDICONICLIVEPREVIEWBITMAP 这两个消息，它们分别是Windows向程序请求Thumbnail和Aero Peek Preview时发送的消息。对于第一个消息，参数wParam的高位和低位分别表示所请求的缩略图的最大宽度和高度。在消息处理中，通过DwmSetIconicThumbnail 将一个位图句柄(HBITMAP)发送给系统。这里系统要求的位图大小不能超过参数传入的最大宽度和高度，而且必须是32位的位图，但是一般的软件只能保存24位的位图，这样的位图不符合要求，是无法显示的。于是我利用GDI+写了两个辅助函数，用于将PNG格式的资源加载为HBITMAP，以及缩放大小。
第一个函数是加载PNG格式的资源，参数分别是：模块句柄（如果是本模块可使用GetModuleHandle(NULL)取得句柄），资源id，资源类型。这段代码所做的就是将资源加载到内存中，并由这块内存创建一个Bitmap对象。
//将PNG等格式的资源加载为 GdiPlus::Bitmap
Gdiplus::Bitmap*LoadBitmapFromResource ( HMODULEhModule,UINTresID,LPCTSTRresType )
{
//分配一块内存，把 加载的资源拷贝到内存中
//取得资源的句柄
HRSRChRsrc=http://blog.soso.com/qz.q/FindResource (hModule,MAKEINTRESOURCE (resID),resType );
if (hRsrc=http://blog.soso.com/qz.q/=NULL )
{
returnNULL ;
}
//资源的大小
intsize=SizeofResource (GetModuleHandle (NULL),hRsrc );
//加载资源
HGLOBALhGlobal=LoadResource (GetModuleHandle (NULL),hRsrc );
if (hGlobal==NULL )
{
returnNULL ;
}
//分配相同大小的一块内存
HGLOBALhGlobal2=GlobalAlloc (GMEM_MOVEABLE,size );
if (hGlobal2==NULL )
{
FreeResource (hGlobal );
returnNULL ;
}
//锁资源
LPVOIDlpVoid=LockResource (hGlobal );
if (lpVoid==NULL )
{
FreeResource (hGlobal );
GlobalFree (hGlobal2 );
returnNULL ;
}
//锁内存
LPVOIDlpVoid2=GlobalLock (hGlobal2 );
if (lpVoid2==NULL )
{
UnlockResource (hGlobal );
FreeResource (hGlobal );
GlobalFree (hGlobal2 );
returnNULL ;
}
//将资源拷贝到内存
memcpy (lpVoid2,lpVoid,size );
//解锁
GlobalUnlock (hGlobal2 );
UnlockResource (hGlobal );
//创建流
LPSTREAMlpStream ;
HRESULThr=CreateStreamOnHGlobal (hGlobal2,TRUE,&lpStream );
if (hr!=S_OK )
{
FreeResource (hGlobal );
GlobalFree (hGlobal2 );
returnNULL ;
}
//基于流创建GdiPlus::Bitmap
Gdiplus::Bitmap*bmp=Gdiplus::Bitmap::FromStream (lpStream );
//释放资源和内存
FreeResource (hGlobal );
GlobalFree (hGlobal2 );
returnbmp ;
}
第二个函数是缩放Bitmap对象，最后一个参数可以选择是否要保持长宽比
//缩放 GdiPlua::Bitmap
Gdiplus::Bitmap*ResizeBitmap ( Gdiplus::Bitmap*bmpSrc, intdestWidth,intdestHeight,boolkeepAspect=true )
{
//取得源图片宽度和高度
intsrcWidth=bmpSrc->GetWidth ();
intsrcHeight=bmpSrc->GetHeight ();
//计算横向和纵向的缩放比率
floatscaleH= (float )destWidth/srcWidth ;
floatscaleV= (float )destHeight/srcHeight ;
//如果需要保持长宽比，则横向和纵向统一采用较小的缩放比率
if (keepAspect )
{
if (scaleH>scaleV )
{
scaleH=scaleV ;
}
else
{
scaleV=scaleH ;
}
}
//计算目标宽高
destWidth = (int )(srcWidth*scaleH );
destHeight= (int )(srcHeight*scaleV );
//创建目标Bitmap
Gdiplus::Bitmap*bmpDest=newGdiplus::Bitmap (destWidth,destHeight,PixelFormat32bppARGB );
Gdiplus::Graphicsgraphic (bmpDest );
//设置插值算法
graphic.SetInterpolationMode (Gdiplus::InterpolationModeHighQualityBicubic );
//将源图像绘制到目 标图像上
graphic.DrawImage (bmpSrc,Gdiplus::Rect (0,0,destWidth,destHeight),
0,0,srcWidth,srcHeight,Gdiplus::UnitPixel );
graphic.Flush ();
returnbmpDest ;
}
在调用这两个函数之前，还有一点工作要做。那就是要初始化GDI+。在WinMain函数的开头，加入下面的初始化代码：
//初始化GDI+
ULONG_PTRtoken ;
Gdiplus::GdiplusStartupInputinput ;
Gdiplus::GdiplusStartup (&token,&input,NULL );
在WinMain函数结束的时候别忘了关闭GDI+:
//关闭GDI+
Gdiplus::GdiplusShutdown (token );
准备工作做好以后，可以正式来处理缩略图了。消息处理函数中，加入下面的消息处理代码：
caseWM_DWMSENDICONICTHUMBNAIL:
OnSendThumbnail (hWnd,HIWORD (lParam),LOWORD (lParam ));
break ;
在这里我们得到了缩略图需要的宽和高，转到OnSendThumbnail函数中处理。
voidOnSendThumbnail ( HWNDhWnd,intwidth,intheight )
{
//将资源加载为Bitmap
Gdiplus::Bitmap*bmp=LoadBitmapFromResource (GetModuleHandle (NULL),IDB_THUMB,TEXT ("PNG" ));
//缩放Bitmap
Gdiplus::Bitmap*bmpResized=ResizeBitmap (bmp,width,height,false );
//取得位图句柄
HBITMAPhbmp ;
bmpResized->GetHBITMAP (UINT (Gdiplus::Color::AlphaMask),&hbmp );
//发送位图句柄
DwmSetIconicThumbnail (hWnd,hbmp,0 );
//释放对象
DeleteObject (hbmp );
deletebmpResized ;
deletebmp ;
}
因为没有保持长宽比，所以得到下面的效果：
如果保持长宽比，将得到下面的效果：
接下来处理Aero Peek预览图，对应的Windows消息是WM_DWMSENDICONICLIVEPREVIEWBITMAP , 但是在该消息的参数中，没有提供宽和高。而如果我们提供的预览图的宽和高超过了窗口的客户区大小，同样是不能显示的。所以我们要手动获取客户区的大小，然后将图像缩放到客户区的尺寸。加入如下消息处理：
caseWM_DWMSENDICONICLIVEPREVIEWBITMAP:
OnSendPreview (hWnd );
break ;
voidOnSendPreview ( HWNDhWnd )
{
//取得窗口客户区域
RECTrcClient ;
GetClientRect (hWnd,&rcClient );
//将资源加载为 Bitmap
Gdiplus::Bitmap*bmp=LoadBitmapFromResource (GetModuleHandle (NULL),IDB_PREVIEW,TEXT ("PNG" ));
Gdiplus::Bitmap*bmpResized=ResizeBitmap (bmp,rcClient.right-rcClient.left,
rcClient.bottom-rcClient.top,false );
//取得位图句柄
HBITMAPhbmp ;
bmpResized->GetHBITMAP (UINT (Gdiplus::Color::AlphaMask),&hbmp );
//发送位图句柄
DwmSetIconicLivePreviewBitmap (hWnd,hbmp,NULL,0 );
//释放对象
DeleteObject (hbmp );
deletebmpResized ;
deletebmp ;
}
得到下面的效果 ，这张变形金刚的图片是我们发送给Windows的预览图，实际程序的界面上并没有这张图 。
有一点要提醒一下，Windows会将缩略图缓存，并不会每次都向程序请求缩略图，所以如果要更新缩略图的话需要调用API函数DwmInvalidateIconicBitmaps ，这样当Windows再次需要显示缩略图时，就会发送WM_DWMSENDICONICTHUMBNAIL消息，向应用程序请求缩略图。
至此，上面提到的所有功能都已实现。有几个头文件需要包含到程序中：
#include <shobjidl.h>
#include <dwmapi.h>
#include <tchar.h>
#include <strsafe.h>
#include <GdiPlus.h>
编译时需要链接的库有：dwmapi.lib gdiplus.lib
