MMC_LISTPAD_INFO Struktur (mmc.h)
Die MMC_LISTPAD_INFO-Struktur wird in MMC 1.1 eingeführt.
Die MMC_LISTPAD_INFO-Struktur wird von der IExtendTaskPad::GetListPadInfo-Methode ausgefüllt, um die folgenden Informationen für ein Listenansicht-Taskpad anzugeben:
- Titeltext für das Listensteuerelement
- Text für eine optionale Schaltfläche
- Die Befehls-ID, die an IExtendTaskPad::TaskNotify übergeben wird, wenn auf diese Schaltfläche geklickt wird.
Syntax
typedef struct _MMC_LISTPAD_INFO {
LPOLESTR szTitle;
LPOLESTR szButtonText;
LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;
Members
szTitle
Ein Zeiger auf eine NULL-Zeichenfolge, die den Text enthält, der direkt über dem Listensteuerelement platziert wird. Dieser Text kann die Bezeichnung für die Objekte innerhalb des Listensteuerelements sein (z. B. "Drucker", wenn die Liste Drucker enthält) oder Anweisungen (z. B. "Wählen Sie einen Drucker aus, und klicken Sie auf eine auszuführende Aktion.").
Wenn szTitleNULL oder leer ist, wird kein Titel für das Listensteuerelement angezeigt.
Beachten Sie, dass der szTitle-Member nicht mit dem pszTitle-Parameter für IExtendTaskPad::GetTitle identisch ist. Die IExtendTaskPad::GetTitle-Methode gibt den Titel für das gesamte Taskpad zurück, das oben auf dem Taskpad angezeigt wird und auf jedem standardmäßigen MMC-Taskpad angezeigt wird. Das szTitle-Element von MMC_LISTPAD_INFO ist die Bezeichnung für das Listensteuerelement und wird nur auf Taskpads der MMC-Listenansicht angezeigt.
szButtonText
Ein Zeiger auf eine NULL-Zeichenfolge, die den Text enthält, der auf einer Schaltfläche platziert wird, die sich direkt über dem Listensteuerelement und rechts neben dem szTitle-Text befindet.
Wenn der Benutzer auf diese Schaltfläche im Taskpad klickt, ruft MMC die IExtendTaskPad::TaskNotify-Methode des Snap-Ins auf und übergibt den in nCommandID angegebenen Wert als VARIANT-Struktur im arg-Parameter. Das an TaskNotify übergebene VARIANT-Element verfügt über einen vt-Member auf VT_I4 und einen lVal-Member, der die Befehls-ID enthält.
Damit die Schaltfläche ohne Text angezeigt wird, legen Sie szButtonText auf eine leere Zeichenfolge fest.
Um diese Schaltfläche so auszublenden, dass sie auf dem Taskpad angezeigt wird, legen Sie szButtonText auf NULL fest.
nCommandID
Wert, der als Bezeichner für die von szButtonText angegebene Schaltfläche dient. Es wird empfohlen, dass Sie diesen Wert für jedes Taskpad eindeutig festlegen, um das Taskpad zu identifizieren, das die Benachrichtigung per Mausklick gesendet hat.
Wenn der Benutzer auf diese Schaltfläche klickt, ruft MMC die IExtendTaskPad::TaskNotify-Methode des Snap-Ins auf und übergibt diesen Wert als VARIANT im arg-Parameter.
Dieser Wert wird ignoriert, wenn szButtonTextNULL ist.
Hinweise
Ordnen Sie die Zeichenfolgen szTitle und szButtonText mit der COM-API-Funktion CoTaskMemAlloc (oder der entsprechenden) zu, und MMC gibt sie frei.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Kopfzeile | mmc.h |