IExtendTaskPad::TaskNotify-Methode (mmc.h)

Mit der IExtendTaskPad::TaskNotify-Methode kann MMC das Snap-In benachrichtigen, wenn eine Aufgabe erweitert wird. Wenn es sich bei dem Taskpad um ein Taskpad mit Listenansicht handelt, ruft MMC auch IExtendTaskPad::TaskNotify auf, wenn eine Listenansichtsschaltfläche erweitert wird.

Syntax

HRESULT TaskNotify(
  [in] IDataObject *pdo,
  [in] VARIANT     *arg,
  [in] VARIANT     *param
);

Parameter

[in] pdo

Ein Zeiger auf das Datenobjekt für das Bereichselement, das das Taskpad besitzt. Wenn Ihr Snap-In das Element besitzt, das das Taskpad anzeigt, ist pdo ein Zeiger auf dieses Element. Wenn Ihr Snap-In das Taskpad eines anderen Snap-Ins erweitert, ist pdo ein Zeiger auf das Element im Snap-In, das das Taskpad besitzt.

[in] arg

Ein Zeiger auf eine VARIANT-Struktur, die Informationen enthält, die vom CIC-Steuerelement auf dem Taskpad zurückgegeben werden.

Taskpads mit MMC-Taskpadvorlagen

Für die von MMC bereitgestellten Taskpads enthält die VARIANT-Struktur die Befehls-ID für die Taskpadtask- oder Listenansichtsschaltfläche, die ed wurde.

Das vt-Feld ist VT_I4, und das Feld lVal enthält die Befehls-ID für den Taskpadtask oder die Listenansichtsschaltfläche, die ed wurde. Listenansichtsschaltflächen gelten nur für Taskpads mit Listenansicht.

Eine Aufgabenbefehls-ID wird im nCommandID-Member der MMC_TASK-Struktur angegeben, das in der IEnumTASK::Next-Methode übergeben wird, die MMC aufruft, wenn die Informationen für diese Aufgabe während der Einrichtung des Taskpads abgerufen werden.

Eine Listenansichtsschaltfläche ist die Schaltfläche, die im szButtonText-Member der MMC_LISTPAD_INFO-Struktur angegeben ist, die in der IExtendTaskPad::GetListPadInfo-Methode übergeben wird, die MMC beim Einrichten des Taskpads listenansicht aufruft. Die Befehls-ID der Listenansicht-Schaltfläche wird im nCommandID-Member von MMC_LISTPAD_INFO angegeben.

Taskpads mit benutzerdefinierten HTML-Seiten

Bei benutzerdefinierten Taskpads kann die VARIANT-Struktur alle Daten enthalten, die das Skript auf der benutzerdefinierten HTML-Seite über das CIC-Objekt TaskNotify-Methode übergeben möchte.

[in] param

Ein Zeiger auf eine VARIANT-Struktur, die Informationen enthält, die vom CIC-Steuerelement auf dem Taskpad zurückgegeben werden.

Taskpads, die die MMC-Taskpadvorlagen verwenden, ignorieren diesen Parameter. Benutzerdefinierte Taskpads können sie jedoch verwenden, um einen zusätzlichen Wert zurück an das Snap-In zu übergeben.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Das Snap-In kann das Bereichselement, das das Taskpad besitzt, mithilfe des pdo-Zeigers identifizieren. Anschließend kann die Aufgabe anhand des im arg-Parameter zurückgegebenen VARIANT-Werts identifiziert werden. Wenn es sich bei dem Taskpad um ein Taskpad mit Listenansicht handelt, kann das Snap-In das ausgewählte Element (oder Elemente, wenn multiselection unterstützt wird) in einer Ergebnisliste mithilfe der IResultData-Schnittstelle identifizieren. Basierend auf diesen Daten kann das Snap-In die entsprechenden Aktionen für das entsprechende Objekt ausführen.

Wenn eine Taskpad-Listenansichtsschaltfläche für ein Taskpad mit Listenansicht erstellt wird, kann das Snap-In die Schaltfläche für das jeweilige Taskpad anhand des im arg-Parameter zurückgegebenen VARIANT-Werts identifizieren.

Ein benutzerdefiniertes Taskpad kann alle Werte übergeben, die in den Parametern arg und param gesendet werden sollen.

Anforderungen

Weitere Informationen

IEnumTASK

IExtendTaskPad