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

El método IExtendTaskPad::TaskNotify permite a MMC notificar al complemento cuando se extiende una tarea. Si el panel de tareas es un panel de tareas de vista de lista, MMC también llama a IExtendTaskPad::TaskNotify cuando se extiende un botón de vista de lista.

Sintaxis

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

Parámetros

[in] pdo

Puntero al objeto de datos del elemento de ámbito que posee el panel de tareas. Si el complemento posee el elemento que muestra el panel de tareas, pdo es un puntero a ese elemento. Si el complemento extiende el panel de tareas de otro complemento, pdo es un puntero al elemento del complemento que posee el panel de tareas.

[in] arg

Puntero a una estructura VARIANT que contiene información pasada desde el control CIC en el panel de tareas.

Paneles de tareas con plantillas de panel de tareas MMC

Para los paneles de tareas proporcionados por MMC, la estructura VARIANT contiene el identificador de comando para la tarea del panel de tareas o el botón de vista de lista que se ha modificado.

El campo vt es VT_I4 y el campo lVal contiene el identificador de comando para la tarea del panel de tareas o el botón de vista de lista que se ed. Los botones de vista de lista solo se aplican a los paneles de tareas de vista de lista.

Se especifica un identificador de comando de tarea en el miembro nCommandID de la estructura MMC_TASK , que se pasa en el método IEnumTASK::Next al que MMC llama cuando recupera la información de esa tarea durante la instalación del panel de tareas.

Un botón de vista de lista es el botón especificado en el miembro szButtonText de la estructura MMC_LISTPAD_INFO , que se pasa en el método IExtendTaskPad::GetListPadInfo al configurar el panel de tareas de vista de lista. El identificador de comando del botón de vista de lista se especifica en el miembro nCommandID de MMC_LISTPAD_INFO.

Paneles de tareas con páginas HTML personalizadas

En el caso de los controladores de tareas personalizados, la estructura VARIANT puede contener cualquier dato que el script de la página HTML personalizada quiera pasar a través del método TaskNotify del objeto CIC.

[in] param

Puntero a una estructura VARIANT que contiene información pasada desde el control CIC en el panel de tareas.

Los paneles de tareas que usan las plantillas del panel de tareas MMC omiten este parámetro. Sin embargo, los controladores de tareas personalizados pueden usarlo para volver a pasar un valor adicional al complemento.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

El complemento puede identificar el elemento de ámbito que posee el panel de tareas mediante el puntero pdo; a continuación, puede identificar la tarea por el valor VARIANT devuelto en el parámetro arg. Si el panel de tareas es un panel de tareas de vista de lista, el complemento puede identificar el elemento seleccionado (o los elementos si se admite la selección múltiple) en una lista de resultados mediante la interfaz IResultData . En función de estos datos, el complemento puede realizar las acciones adecuadas en el objeto adecuado.

Si un botón list-view del panel de tareas del panel de tareas se usa para un panel de tareas de vista de lista, el complemento puede identificar el botón del panel de tareas concreto por el valor VARIANT devuelto en el parámetro arg.

Un panel de tareas personalizado puede pasar cualquier valor que determine que se debe enviar en los parámetros arg y param.

Requisitos

Consulte también

IEnumTASK

IExtendTaskPad