MMC_TASK_DISPLAY_BITMAP Struktur (mmc.h)

Die MMC_TASK_DISPLAY_BITMAP-Struktur wird in MMC 1.1 eingeführt.

Die MMC_TASK_DISPLAY_BITMAP-Struktur wird für das uBitmap-Element der MMC_TASK_DISPLAY_OBJECT-Struktur verwendet, um alle Daten anzugeben, die zum Anzeigen eines GIF- oder Bitmapbilds für eine Aufgabe oder einen Hintergrund auf einem Taskpad erforderlich sind.

Syntax

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

Members

szMouseOverBitmap

Ein Zeiger auf eine null-beendete Zeichenfolge, die den Ressourcenpfad zur Bilddatei für das Für die Aufgabe angezeigte Bild enthält, wenn der Benutzer die Maus über den Bild- oder Textbereich des Vorgangs bewegt.

Die Zeichenfolge sollte die folgende Form aufweisen:

"res:// filepath/imgpath"

wobei filepath der vollständige Pfad zur DLL des Snap-Ins ist, die die Imagedatei als Ressource speichert, und imgpath ist der Ressourcenpfad der Imagedatei mit der Snap-In-DLL.

Die folgende Zeichenfolge gibt beispielsweise an, dass die Snap-In-DLL (snapin.dll) den Pfad "c:\windows\system32\snapin.dll" aufweist und dass der Ressourcenpfad img/mon.gif lautet: "res://c:\windows\system32\snapin.dll/img/mon.bmp".

Wenn szMouseOverBitmap auf eine NULL-Zeichenfolge verweist, muss szMouseOffBitmap eine gültige Zeichenfolge sein, die den Speicherort eines gültigen Bilds enthält. Wenn eine dieser Zeichenfolgen NULL ist, wird die andere Zeichenfolge für beide verwendet. Wenn beide Mausbildpositionen NULL sind, wird die Aufgabe nicht angezeigt.

szMouseOffBitmap

Ein Zeiger auf eine NULL-Zeichenfolge, die den Ressourcenpfad zur Bilddatei für das für die Aufgabe angezeigte Bild enthält, wenn sich die Maus nicht im Bild- oder Textbereich der Aufgabe befindet.

Das Format der Zeichenfolge finden Sie unter szMouseOverBitmap .

Wenn szMouseOffBitmap auf eine NULL-Zeichenfolge verweist, muss szMouseOverBitmap eine gültige Zeichenfolge sein, die den Speicherort eines gültigen Bilds enthält. Wenn eine dieser Zeichenfolgen NULL ist, wird die andere Zeichenfolge für beide verwendet. Wenn beide Mausbildpositionen NULL sind, wird die Aufgabe nicht angezeigt.

Hinweise

Ordnen Sie die in der Struktur verwendeten Zeichenfolgen szMouseOverBitmap und szMouseOffBitmap mit der COM-API-Funktion CoTaskMemAlloc (oder der entsprechenden) zu, und MMC gibt sie frei.

Wenn sowohl szMouseOverBitmap als auch szMouseOffBitmap auf eine NULL-Zeichenfolge zeigen, wird die Aufgabe nicht auf dem Taskpad angezeigt. Wenn eine dieser Zeichenfolgen NULL ist, wird die andere Zeichenfolge für beide verwendet.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Kopfzeile mmc.h

Weitere Informationen

IEnumTASK::Weiter

IExtendTaskPad::GetBackground

MMC_TASK_DISPLAY_OBJECT

MMC_TASK_DISPLAY_SYMBOL

MMC_TASK_DISPLAY_TYPE