Clase CMFCTasksPaneTask
La clase CMFCTasksPaneTask es un asistente que representa las tareas para el control del panel de tareas ( CMFCTasksPane). El objeto de tarea representa un elemento del grupo de tareas ( CMFCTasksPaneTaskGroup). Cada tarea puede tener un comando que el marco ejecuta cuando un usuario hace clic en la tarea y en un icono que aparece a la izquierda del nombre de tarea.
Sintaxis
class CMFCTasksPaneTask : public CObject
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CMFCTasksPaneTask::CMFCTasksPaneTask | Crea e inicializa un objeto CMFCTasksPaneTask. |
CMFCTasksPaneTask::~CMFCTasksPaneTask |
Destructor. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CMFCTasksPaneTask::SetACCData | Determina los datos de accesibilidad de la tarea actual. |
Miembros de datos
| Nombre | Descripción |
|---|---|
| CMFCTasksPaneTask::m_bAutoDestroyWindow | Determina si la ventana de tareas se destruye automáticamente. |
| CMFCTasksPaneTask::m_bIsBold | Determina si el marco dibuja una etiqueta de tarea en negrita. |
| CMFCTasksPaneTask::m_dwUserData | Contiene los datos definidos por el usuario que el marco asocia a la tarea. Se establece en cero si la tarea no tiene datos asociados. |
| CMFCTasksPaneTask::m_hwndTask | Identificador de la ventana de tareas. |
| CMFCTasksPaneTask::m_nIcon | Índice en la lista de imágenes de la imagen que muestra el marco junto a la tarea. |
| CMFCTasksPaneTask::m_nWindowHeight | La altura de la ventana de tareas. Si la tarea no tiene ninguna ventana de tareas, este valor es cero. |
| CMFCTasksPaneTask::m_pGroup | Puntero al que CMFCTasksPaneTaskGroup pertenece esta tarea. |
| CMFCTasksPaneTask::m_rect | Especifica el rectángulo delimitador del grupo. |
| CMFCTasksPaneTask::m_strName | Nombre de la tarea. |
| CMFCTasksPaneTask::m_uiCommandID | Especifica el identificador de comando que se va a ejecutar cuando el usuario hace clic en la tarea. Si este valor no es un identificador de comando válido, la tarea se trata como una etiqueta simple. |
Comentarios
En la ilustración siguiente se muestra un grupo de tareas que contiene tres tareas:
Nota:
Si una tarea no tiene un identificador de comando válido, se trata como una etiqueta simple.
Jerarquía de herencia
Requisitos
Encabezado: afxTasksPane.h
CMFCTasksPaneTask::CMFCTasksPaneTask
Crea e inicializa un objeto CMFCTasksPaneTask.
CMFCTasksPaneTask(
CMFCTasksPaneTaskGroup* pGroup,
LPCTSTR lpszName,
int nIcon,
UINT uiCommandID,
DWORD dwUserData = 0,
HWND hwndTask = NULL,
BOOL bAutoDestroyWindow = FALSE,
int nWindowHeight = 0);
Parámetros
pGroup
Especifica el cmFCTasksPaneTaskGroup al que pertenece la tarea.
lpszName
Especifica el nombre de la tarea.
nIcon
Especifica el índice de la imagen de la tarea en la lista de imágenes.
uiCommandID
Especifica el identificador de comando que se ejecuta cuando se hace clic en la tarea.
dwUserData
Datos definidos por el usuario.
hwndTask
Especifica el manipulador de la ventana de tareas.
bAutoDestroyWindow
Si es TRUE, la ventana de tareas se destruirá automáticamente.
nWindowHeight
Especifica el alto de la ventana de tareas.
Comentarios
CMFCTasksPaneTask::m_bAutoDestroyWindow
Determina si la ventana de tareas se destruye automáticamente.
BOOL m_bAutoDestroyWindow;
Comentarios
Establezca en TRUE para especificar que la ventana de tareas ( CMFCTasksPaneTask::m_hwndTask) se debe destruir automáticamente; de lo contrario, FALSE.
CMFCTasksPaneTask::m_bIsBold
Determina si una etiqueta de tarea se dibuja en texto en negrita.
BOOL m_bIsBold;
Comentarios
Establezca este miembro en TRUE para mostrar texto en negrita para la etiqueta de tarea.
CMFCTasksPaneTask::m_dwUserData
Contiene los datos definidos por el usuario asociados a la tarea. Se establece en cero si no hay datos asociados a la tarea.
DWORD m_dwUserData;
Comentarios
CMFCTasksPaneTask::m_hwndTask
Identificador de la ventana de tareas.
HWND m_hwndTask;
Comentarios
Para agregar una ventana de tareas, llame a CMFCTasksPane::AddWindow.
CMFCTasksPaneTask::m_nIcon
Posición de índice en una lista de imágenes que identifica una imagen que se muestra junto a la tarea especificada.
int m_nIcon;
Comentarios
La lista de imágenes se establece mediante CMFCTasksPane::SetIconsList.
Establezca m_nIcon en -1 si desea mostrar la tarea sin una imagen.
CMFCTasksPaneTask::m_nWindowHeight
La altura de la ventana de tareas. Si la tarea no tiene ninguna ventana de tareas, este valor es cero.
int m_nWindowHeight;
Comentarios
CMFCTasksPaneTask::m_pGroup
Puntero a el cmFCTasksPaneTaskGroup al cual pertenece la tarea.
CMFCTasksPaneTaskGroup* m_pGroup;
Comentarios
Cada tarea debe tener un grupo primario. Los grupos se añaden a un panel de tareas al llamar a CMFCTasksPane::AddGroup.
CMFCTasksPaneTask::m_rect
Especifica el rectángulo delimitador del grupo.
CRect m_rect;
Comentarios
Este valor es calculado por el marco cuando se dibuja la tarea.
CMFCTasksPaneTask::m_strName
Nombre de la tarea.
CString m_strName;
Comentarios
CMFCTasksPaneTask::m_uiCommandID
Especifica el identificador de comando que se ejecuta cuando el usuario hace clic en la tarea. Si este valor no es un identificador de comando válido, la tarea se trata como una etiqueta simple.
UINT m_uiCommandID;
Comentarios
CMFCTasksPaneTask::SetACCData
Determina los datos de accesibilidad de la tarea actual.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parámetros
pParent
[in] Representa la ventana principal de la tarea actual.
data
[out] Objeto de tipo CAccessibilityData que se rellena con los datos de accesibilidad de la tare actual.
Valor devuelto
TRUE si el parámetro data se ha rellenado correctamente con los datos de accesibilidad de la tarea actual; de lo contrario, FALSE.