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

CObject

CMFCTasksPaneTask

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 Devolução

TRUE se o parâmetro dados tiver sido preenchido com êxito com os dados de acessibilidade da tarefa atual; caso contrário, FALSE.

Confira também

Gráfico da hierarquia
Classes
Classe CObject