MMC_TASK_DISPLAY_BITMAP結構 (mmc.h)

MMC_TASK_DISPLAY_BITMAP結構是在 MMC 1.1 中引進。

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 的完整路徑，會將影像檔儲存為資源， 而 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，則不會顯示工作。

配置結構中使用的 szMouseOverBitmap 和 szMouseOffBitmap 字串搭配 COM API 函式 CoTaskMemAlloc (或對等的) ，且 MMC 會釋放它們。

如果 szMouseOverBitmap 和 szMouseOffBitmap 都指向 Null 字串，工作就不會出現在任務臺上。如果其中一個字串是 Null，則另一個字串會用於兩者。