MMC_TASK_DISPLAY_BITMAP構造体 (mmc.h)
MMC_TASK_DISPLAY_BITMAP構造は MMC 1.1 で導入されています。
MMC_TASK_DISPLAY_BITMAP構造体は、タスクパッド上のタスクまたは背景の GIF またはビットマップ イメージを表示するために必要なすべてのデータを指定するために、MMC_TASK_DISPLAY_OBJECT構造体の uBitmap メンバーに使用されます。
構文
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 は有効なイメージの場所を含む有効な文字列である必要があります。 これらの文字列の 1 つが NULL の場合、もう一方の文字列は両方に使用されます。 両方のマウス イメージの場所が NULL の場合、タスクは表示されません。
szMouseOffBitmap
マウスがタスクの画像またはテキスト領域にない場合に、タスクに対して表示されるイメージのイメージ ファイルへのリソース パスを含む null で終わる文字列へのポインター。
文字列の形式については、「 szMouseOverBitmap 」を参照してください。
szMouseOffBitmap が NULL 文字列を指している場合、szMouseOverBitmap は有効なイメージの場所を含む有効な文字列である必要があります。 これらの文字列の 1 つが NULL の場合、もう一方の文字列は両方に使用されます。 両方のマウス イメージの場所が NULL の場合、タスクは表示されません。
解説
構造体で使用される szMouseOverBitmap 文字列と szMouseOffBitmap 文字列を COM API 関数 CoTaskMemAlloc (またはそれと同等のもの) と共に割り当てると、MMC はそれらを解放します。
szMouseOverBitmap と szMouseOffBitmap の両方が NULL 文字列を指している場合、タスクはタスクパッドに表示されません。 これらの文字列の 1 つが NULL の場合、もう一方の文字列は両方に使用されます。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| Header | mmc.h |