estructura MMC_LISTPAD_INFO (mmc.h)
La estructura MMC_LISTPAD_INFO se introduce en MMC 1.1.
El método IExtendTaskPad::GetListPadInfo rellena la estructura MMC_LISTPAD_INFO para especificar la siguiente información para un panel de tareas de vista de lista:
- Texto del título del control de lista
- Texto para un botón opcional
- Identificador de comando pasado a IExtendTaskPad::TaskNotify cuando se hace clic en ese botón.
Sintaxis
typedef struct _MMC_LISTPAD_INFO {
LPOLESTR szTitle;
LPOLESTR szButtonText;
LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;
Members
szTitle
Puntero a una cadena terminada en null que contiene el texto colocado directamente encima del control de lista. Este texto puede ser la etiqueta de los objetos dentro del control de lista (como "Impresoras" si la lista contiene impresoras) o instrucciones (como "Seleccionar una impresora y hacer clic en una acción para realizar").
Si szTitle es NULL o está vacío, no se muestra ningún título para el control de lista.
Tenga en cuenta que el miembro szTitle no es el mismo que el parámetro pszTitle para IExtendTaskPad::GetTitle. El método IExtendTaskPad::GetTitle devuelve el título de todo el panel de tareas que aparece en la parte superior del panel de tareas y aparece en cada panel de tareas MMC estándar. El miembro szTitle de MMC_LISTPAD_INFO es la etiqueta del control de lista y solo aparece en los paneles de tareas de vista de lista mmC.
szButtonText
Puntero a una cadena terminada en null que contiene el texto colocado en un botón que está directamente encima del control de lista y a la derecha del texto szTitle .
Cuando el usuario hace clic en este botón en el panel de tareas, MMC llama al método IExtendTaskPad::TaskNotify del complemento y pasa el valor especificado en nCommandID como una estructura VARIANT en el parámetro arg. Variant pasado a TaskNotify tiene un miembro vt establecido en VT_I4 y un miembro lVal que contiene el identificador de comando.
Para que el botón aparezca sin texto, establezca szButtonText en una cadena vacía.
Para ocultar este botón para que aparezca en el panel de tareas, establezca szButtonText en NULL.
nCommandID
Valor que actúa como identificador para el botón especificado por szButtonText. Se recomienda que este valor sea único para cada panel de tareas para ayudar a identificar el panel de tareas que envió la notificación de clic con el botón.
Cuando el usuario hace clic en este botón, MMC llama al método IExtendTaskPad::TaskNotify del complemento y pasa este valor como VARIANT en el parámetro arg.
Este valor se omite si szButtonText es NULL.
Comentarios
Asigne las cadenas szTitle y szButtonText con la función de API COM CoTaskMemAlloc (o el equivalente) y MMC la liberará.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | mmc.h |