MMC_TASK_DISPLAY_BITMAP 结构 (mmc.h)

MMC 1.1 中引入了MMC_TASK_DISPLAY_BITMAP结构。

MMC_TASK_DISPLAY_BITMAP 结构用于MMC_TASK_DISPLAY_OBJECT结构的 uBitmap 成员，以指定在任务板上显示任务或背景的 GIF 或位图图像所需的所有数据。

语法

typedef struct _MMC_TASK_DISPLAY_BITMAP {
  LPOLESTR szMouseOverBitmap;
  LPOLESTR szMouseOffBitmap;
} MMC_TASK_DISPLAY_BITMAP;

szMouseOverBitmap

指向以 null 结尾的字符串的指针，该字符串包含用户将鼠标移到任务的图像或文本区域时为任务显示的图像的图像文件的资源路径。

字符串应采用以下形式：

“res:// filepath/imgpath”

其中 ，filepath 是管理单元的 DLL 的完整路径，该 DLL 将图像文件存储为资源， imgpath 是包含管理单元 DLL 的图像文件的资源路径。

例如，以下字符串指定管理单元 DLL (snapin.dll) 的路径为“c:\windows\system32\snapin.dll”，资源路径为 img/mon.gif：“res：//c:\windows\system32\snapin.dll/img/mon.bmp”。

如果 szMouseOverBitmap 指向 NULL 字符串， 则 szMouseOffBitmap 必须是包含有效图像位置的有效字符串。如果其中一个字符串为 NULL，则另一个字符串用于这两个字符串。如果两个鼠标图像位置均为 NULL，则不显示任务。

szMouseOffBitmap

指向以 null 结尾的字符串的指针，该字符串包含当鼠标不在任务的图像或文本区域中时为任务显示的图像的图像文件的资源路径。

有关字符串的格式，请参阅 szMouseOverBitmap 。

如果 szMouseOffBitmap 指向 NULL 字符串， 则 szMouseOverBitmap 必须是包含有效图像位置的有效字符串。如果其中一个字符串为 NULL，则另一个字符串用于这两个字符串。如果两个鼠标图像位置均为 NULL，则不显示任务。

使用 COM API 函数 CoTaskMemAlloc 或等效 () 分配结构中使用的 szMouseOverBitmap 和 szMouseOffBitmap 字符串，MMC 将释放它们。

如果 szMouseOverBitmap 和 szMouseOffBitmap 都指向 NULL 字符串，则任务不会显示在任务板上。如果其中一个字符串为 NULL，则另一个字符串用于这两个字符串。