Méthode IExtendTaskPad::TaskNotify (mmc.h)

La méthode IExtendTaskPad::TaskNotify permet à MMC d’avertir le composant logiciel enfichable lorsqu’une tâche est étendue. Si le bloc-tâches est un bloc-tâches d’affichage de liste, MMC appelle également IExtendTaskPad::TaskNotify lorsqu’un bouton d’affichage de liste est étendu.

Syntaxe

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

Paramètres

[in] pdo

Pointeur vers l’objet de données pour l’élément d’étendue propriétaire du bloc-tâches. Si votre composant logiciel enfichable possède l’élément qui affiche le bloc-tâches, pdo est un pointeur vers cet élément. Si votre composant logiciel enfichable étend le bloc-tâches d’un autre composant logiciel enfichable, pdo est un pointeur vers l’élément du composant logiciel enfichable propriétaire du bloc-tâches.

[in] arg

Pointeur vers une structure VARIANT qui contient des informations transmises à partir du contrôle CIC sur le bloc-tâches.

Taskpads utilisant des modèles de bloc-tâches MMC

Pour les boîtiers de tâches fournis par MMC, la structure VARIANT contient l’ID de commande de la tâche du bloc-tâches ou du bouton d’affichage de liste qui a été inséré.

Le champ vt est VT_I4 et le champ lVal contient l’ID de commande pour la tâche du bloc-tâches ou le bouton d’affichage de liste qui a été ed. Les boutons d’affichage de liste s’appliquent uniquement aux pavés de tâches d’affichage de liste.

Un ID de commande de tâche est spécifié dans le membre nCommandID de la structure MMC_TASK , qui est passé dans la méthode IEnumTASK::Next appelée par MMC lorsqu’elle récupère les informations relatives à cette tâche pendant la configuration du bloc-tâches.

Un bouton d’affichage de liste est le bouton spécifié dans le membre szButtonText de la structure MMC_LISTPAD_INFO , qui est passé dans la méthode IExtendTaskPad::GetListPadInfo que MMC appelle lorsqu’elle configure le bloc-tâches d’affichage de liste. L’ID de commande du bouton list-view est spécifié dans le membre nCommandID de MMC_LISTPAD_INFO.

Pavés de tâches utilisant des pages HTML personnalisées

Pour les pavés de tâches personnalisés, la structure VARIANT peut contenir toutes les données que le script de la page HTML personnalisée souhaite transmettre via la méthode TaskNotify de l’objet CIC

[in] param

Pointeur vers une structure VARIANT qui contient des informations transmises à partir du contrôle CIC sur le bloc-tâches.

Les boîtiers de tâches qui utilisent les modèles de bloc-tâches MMC ignorent ce paramètre. Toutefois, les pavés de tâches personnalisés peuvent l’utiliser pour transmettre une valeur supplémentaire au composant logiciel enfichable.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

Le composant logiciel enfichable peut identifier l’élément d’étendue qui possède le bloc-tâches à l’aide du pointeur pdo ; il peut ensuite identifier la tâche par la valeur VARIANT retournée dans le paramètre arg. Si le bloc-tâches est un bloc-tâches d’affichage de liste, le composant logiciel enfichable peut identifier l’élément sélectionné (ou les éléments si la sélection multiple est prise en charge) dans une liste de résultats à l’aide de l’interface IResultData . En fonction de ces données, le composant logiciel enfichable peut effectuer les actions appropriées sur l’objet approprié.

Si un bouton d’affichage de liste du bloc-tâches du bloc-tâches est défini pour un bloc-tâches d’affichage de liste, le composant logiciel enfichable peut identifier le bouton du bloc-tâches particulier par la valeur VARIANT retournée dans le paramètre arg.

Un bloc-tâches personnalisé peut passer toutes les valeurs qu’il détermine doivent être envoyées dans les paramètres arg et param.

Spécifications

Voir aussi

IEnumTASK

IExtendTaskPad