Classe CMFCTasksPaneTask
A classe CMFCTasksPaneTask é uma classe auxiliar que representa tarefas para o controle do painel de tarefas (CMFCTasksPane). O objeto de tarefa representa um item no grupo de tarefas (CMFCTasksPaneTaskGroup). Cada tarefa pode ter um comando que a estrutura executa quando um usuário clica na tarefa e um ícone que aparece à esquerda do nome da tarefa.
Sintaxe
class CMFCTasksPaneTask : public CObject
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CMFCTasksPaneTask::CMFCTasksPaneTask | Cria e inicializa um objeto CMFCTasksPaneTask. |
CMFCTasksPaneTask::~CMFCTasksPaneTask |
Destruidor. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CMFCTasksPaneTask::SetACCData | Determina os dados de acessibilidade da tarefa atual. |
Membros de dados
| Nome | Descrição |
|---|---|
| CMFCTasksPaneTask::m_bAutoDestroyWindow | Determina se a janela da tarefa é destruída automaticamente. |
| CMFCTasksPaneTask::m_bIsBold | Determina se a estrutura desenha uma etiqueta de tarefa em negrito. |
| CMFCTasksPaneTask::m_dwUserData | Contém dados definidos pelo usuário que a estrutura associa à tarefa. Definido como zero se a tarefa não tem dados associados. |
| CMFCTasksPaneTask::m_hwndTask | Um identificador para a janela de tarefas. |
| CMFCTasksPaneTask::m_nIcon | O índice na lista de imagens da imagem que a estrutura exibe ao lado da tarefa. |
| CMFCTasksPaneTask::m_nWindowHeight | A altura da janela de tarefas. Se a tarefa não tiver nenhuma janela de tarefa, esse valor será zero. |
| CMFCTasksPaneTask::m_pGroup | Um ponteiro para o CMFCTasksPaneTaskGroup ao qual essa tarefa pertence. |
| CMFCTasksPaneTask::m_rect | Especifica o retângulo delimitador da tarefa. |
| CMFCTasksPaneTask::m_strName | Nome da tarefa. |
| CMFCTasksPaneTask::m_uiCommandID | Especifica a ID de comando do comando que a estrutura executa quando o usuário clica na tarefa. Se esse valor não for uma ID de comando válida, a tarefa será tratada como uma etiqueta simples. |
Comentários
A seguinte ilustração mostra um grupo de tarefas que contém três tarefas:
Observação
Se uma tarefa não tiver uma ID de comando válida, ela será tratada como uma etiqueta simples.
Hierarquia de herança
Requisitos
Cabeçalho: afxTasksPane.h
CMFCTasksPaneTask::CMFCTasksPaneTask
Cria e inicializa um 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 o CMFCTasksPaneTaskGroup ao qual a tarefa pertence.
lpszName
Especifica o nome da tarefa.
nIcon
Especifica o índice da imagem da tarefa na lista de imagens.
uiCommandID
Especifica a ID de comando do comando executado quando o usuário clica na tarefa.
dwUserData
Dados definidos pelo usuário.
hwndTask
Especifica o identificador para a janela de tarefas.
bAutoDestroyWindow
Se TRUE, a janela de tarefas será destruída automaticamente.
nWindowHeight
Especifica a altura da janela de tarefa.
Comentários
CMFCTasksPaneTask::m_bAutoDestroyWindow
Determina se a janela da tarefa é destruída automaticamente.
BOOL m_bAutoDestroyWindow;
Comentários
Defina como TRUE para especificar que a janela da tarefa (CMFCTasksPaneTask::m_hwndTask) deve ser destruída automaticamente; caso contrário, FALSE.
CMFCTasksPaneTask::m_bIsBold
Determina se uma etiqueta de tarefa é desenhada em negrito.
BOOL m_bIsBold;
Comentários
Defina esse membro como TRUE para exibir texto em negrito para a etiqueta de tarefa.
CMFCTasksPaneTask::m_dwUserData
Contém dados definidos pelo usuário associados à tarefa. Defina como zero se nenhum dado estiver associado à tarefa.
DWORD m_dwUserData;
Comentários
CMFCTasksPaneTask::m_hwndTask
Um identificador para a janela de tarefas.
HWND m_hwndTask;
Comentários
Para adicionar uma janela de tarefa, chame CMFCTasksPane::AddWindow.
CMFCTasksPaneTask::m_nIcon
A posição do índice em uma lista de imagens que identifica uma imagem exibida ao lado da tarefa especificada.
int m_nIcon;
Comentários
A lista de imagens é definida por CMFCTasksPane::SetIconsList.
Defina m_nIcon como -1 se você quiser exibir a tarefa sem uma imagem.
CMFCTasksPaneTask::m_nWindowHeight
A altura da janela de tarefas. Se a tarefa não tiver nenhuma janela de tarefa, esse valor será zero.
int m_nWindowHeight;
Comentários
CMFCTasksPaneTask::m_pGroup
Ponteiro para o CMFCTasksPaneTaskGroup ao qual essa tarefa pertence.
CMFCTasksPaneTaskGroup* m_pGroup;
Comentários
Cada tarefa deve ter um grupo pai. Você adiciona grupos a um painel de tarefas chamando CMFCTasksPane::AddGroup.
CMFCTasksPaneTask::m_rect
Especifica o retângulo delimitador da tarefa.
CRect m_rect;
Comentários
Esse valor é calculado pela estrutura quando a tarefa é desenhada.
CMFCTasksPaneTask::m_strName
Nome da tarefa.
CString m_strName;
Comentários
CMFCTasksPaneTask::m_uiCommandID
Especifica a ID de comando do comando executado quando o usuário clica na tarefa. Se esse valor não for uma ID de comando válida, a tarefa será tratada como uma etiqueta simples.
UINT m_uiCommandID;
Comentários
CMFCTasksPaneTask::SetACCData
Determina os dados de acessibilidade da tarefa atual.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parâmetros
pParent
[in] Representa a janela pai da tarefa atual.
data
[out] Um objeto do tipo CAccessibilityData preenchido com os dados de acessibilidade da tarefa atual.
Valor de retorno
TRUE se o parâmetro dados tiver sido preenchido com êxito com os dados de acessibilidade da tarefa atual; caso contrário, FALSE.