Classe CMFCTasksPane

Artigo
06/10/2015

Este tópico está incluído para integridade. Para obter mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

A classe de CMFCTasksPane implementa uma lista de itens clicável (tarefas).

class CMFCTasksPane : public CDockablePane

Membros

Construtores public

Nome	Descrição
CMFCTasksPane::CMFCTasksPane	Constrói um objeto de CMFCTasksPane .

Métodos públicos

Nome	Descrição
CMFCTasksPane::AddGroup	Adiciona um novo grupo de tarefas ao controle do painel de tarefas.
CMFCTasksPane::AddLabel	Adiciona um novo rótulo estático no grupo de trabalho especificado.
CMFCTasksPane::AddMRUFilesList	Adiciona as tarefas especificadas por uma lista recentemente usada do arquivo de (MRU) em um grupo.
CMFCTasksPane::AddPage	Adicionar uma nova página ao painel de tarefas.
CMFCTasksPane::AddSeparator
CMFCTasksPane::AddTask	Adiciona uma nova tarefa ao grupo de trabalho especificado.
CMFCTasksPane::AddWindow	Adiciona uma janela filho para o painel de tarefas.
CMFCTasksPane::CollapseAllGroups
CMFCTasksPane::CollapseGroup	Recolhe programaticamente um grupo.
CMFCTasksPane::CreateDefaultMiniframe	Overrides ( CPane::CreateDefaultMiniframe.)
CMFCTasksPane::CreateMenu	Chamado pela estrutura para criar um menu para o botão de menu de Outros painéis de tarefas .
CMFCTasksPane::EnableAnimation	Habilita ou desabilita a animação para expandir ou recolher ao grupos de trabalho.
CMFCTasksPane::EnableGroupCollapse	Especifica se os grupos de tarefas podem ser tomado.
CMFCTasksPane::EnableHistoryMenuButtons	Ativar ou desativar menus suspensos em Avançar e botões de navegação de Anterior .
CMFCTasksPane::EnableNavigationToolbar	Habilita ou desabilita a barra de ferramentas de navegação.
CMFCTasksPane::EnableOffsetCustomControls
CMFCTasksPane::EnableScrollButtons	Permite que os botões de rolagem em vez de uma barra de rolagem.
CMFCTasksPane::EnableWrapLabels	Permite que a palavra ou desativa que envolvem para rótulos.
CMFCTasksPane::EnableWrapTasks	Permite que a palavra ou desativa que envolvem para tarefas.
CMFCTasksPane::GetActivePage	Retorna o índice com base zero para a página.
CMFCTasksPane::GetGroupCaptionHeight	Retorna a altura das legendas de grupo.
CMFCTasksPane::GetGroupCaptionHorzOffset	Retorna o deslocamento atual de uma legenda do grupo das bordas esquerda e direita do painel de tarefas.
CMFCTasksPane::GetGroupCaptionVertOffset	Retorna o deslocamento atual de uma legenda do grupo das bordas de topo e base do painel de tarefas.
CMFCTasksPane::GetGroupCount	Retorna o número total de grupos.
CMFCTasksPane::GetGroupLocation	Retorna o índice de grupo interno para um determinado grupo.
CMFCTasksPane::GetGroupVertOffset	Retorna o deslocamento vertical de um grupo.
CMFCTasksPane::GetHorzMargin	Retorna o espaçamento horizontal entre um painel de tarefas e as bordas da área cliente.
CMFCTasksPane::GetNextPages
CMFCTasksPane::GetPageByGroup	Retorna o índice de página para um grupo especificado.
CMFCTasksPane::GetPagesCount	Retorna o número de páginas.
CMFCTasksPane::GetPreviousPages
CMFCTasksPane::GetScrollBarCtrl	Overrides ( CWnd::GetScrollBarCtrl.)
CMFCTasksPane::GetTask	Recupera uma tarefa.
CMFCTasksPane::GetTaskCount	Retorna o número de itens tarefas em um grupo especificado.
CMFCTasksPane::GetTaskGroup	Retorna um grupo de trabalho para um índice grupo de dado.
CMFCTasksPane::GetTaskLocation	Retorna o grupo e o índice para uma determinada tarefa.
CMFCTasksPane::GetTasksHorzOffset	Retorna o deslocamento horizontal de tarefas das bordas esquerda e direita dos grupos pai.
CMFCTasksPane::GetTasksIconHorzOffset
CMFCTasksPane::GetTasksIconVertOffset
CMFCTasksPane::GetVertMargin	Retorna o espaçamento vertical entre um painel de tarefas e as bordas da área cliente.
CMFCTasksPane::IsAccessibilityCompatible	Overrides ( CDockablePane::IsAccessibilityCompatible.)
CMFCTasksPane::IsAnimationEnabled	Indica se a animação é ativada.
CMFCTasksPane::IsBackButtonEnabled	Indica se o botão voltar está habilitado.
CMFCTasksPane::IsForwardButtonEnabled	Indica se o botão para frente está habilitado.
CMFCTasksPane::IsGroupCollapseEnabled
CMFCTasksPane::IsHistoryMenuButtonsEnabled	Indica se os botões de navegação de Avançar e de Anterior tem menus suspensos.
CMFCTasksPane::IsNavigationToolbarEnabled	Indica se a barra de ferramentas de navegação está habilitada.
CMFCTasksPane::IsToolBox
CMFCTasksPane::IsWrapLabelsEnabled	Indica se o painel de tarefas envolve palavra nos rótulos.
CMFCTasksPane::IsWrapTasksEnabled	Indica se o painel de tarefas envolve palavra nas tarefas.
CMFCTasksPane::LoadState	Overrides ( CDockablePane::LoadState.)
CMFCTasksPane::OnCancel
CMFCTasksPane::OnClickTask	Chamado pela estrutura quando o usuário clica em um item no painel de tarefas.
CMFCTasksPane::OnOK
CMFCTasksPane::OnPressBackButton	Chamado pela estrutura quando o usuário clica no botão novamente.
CMFCTasksPane::OnPressForwardButton	Chamado pela estrutura quando o usuário clica no botão de navegação para.
CMFCTasksPane::OnPressHomeButton	Chamado pela estrutura quando o usuário clica no botão de navegação de início
CMFCTasksPane::OnPressOtherButton
CMFCTasksPane::OnSetAccData	Overrides ( CBasePane::OnSetAccData.)
CMFCTasksPane::OnUpdateCmdUI	Overrides ( CDockablePane::OnUpdateCmdUI.)
CMFCTasksPane::PreTranslateMessage	Overrides ( CDockablePane::PreTranslateMessage.)
CMFCTasksPane::RecalcLayout	Overrides ( CPane::RecalcLayout.)
CMFCTasksPane::RemoveAllGroups	Remove todos os grupos na página especificada.
CMFCTasksPane::RemoveAllPages	Remove todas as páginas do painel de tarefas a não ser que a página padrão (primeira).
CMFCTasksPane::RemoveAllTasks	Remove todas as tarefas de grupo.
CMFCTasksPane::RemoveGroup	Remove um grupo.
CMFCTasksPane::RemovePage	Remove uma página especificada no painel de tarefas.
CMFCTasksPane::RemoveTask	Remove uma tarefa de um grupo de trabalho.
CMFCTasksPane::SaveState	Overrides ( CDockablePane::SaveState.)
CMFCTasksPane::Serialize	Overrides ( CDockablePane::Serialize.)
CMFCTasksPane::SetActivePage	Alterna uma página especificada no painel de tarefas.
CMFCTasksPane::SetCaption	Define o nome da legenda de um painel de tarefas.
CMFCTasksPane::SetGroupCaptionHeight	Defina a altura de uma legenda de grupo.
CMFCTasksPane::SetGroupCaptionHorzOffset	Define o deslocamento horizontal de uma legenda de grupo.
CMFCTasksPane::SetGroupCaptionVertOffset	Define o deslocamento vertical de uma legenda de grupo.
CMFCTasksPane::SetGroupName	Define um nome de grupo.
CMFCTasksPane::SetGroupTextColor	Define a cor do texto para uma legenda de grupo.
CMFCTasksPane::SetGroupVertOffset	Define o deslocamento vertical para um grupo.
CMFCTasksPane::SetHorzMargin	Define o espaçamento horizontal entre um painel de tarefas e as bordas da área cliente.
CMFCTasksPane::SetIconsList	Define a lista de imagem associada com as tarefas.
CMFCTasksPane::SetPageCaption	Define o texto de legenda para uma página do painel de tarefas.
CMFCTasksPane::SetTaskName	Define o nome para uma tarefa.
CMFCTasksPane::SetTasksIconHorzOffset
CMFCTasksPane::SetTasksIconVertOffset
CMFCTasksPane::SetTaskTextColor	Define a cor do texto para uma tarefa.
CMFCTasksPane::SetTasksHorzOffset	Define o deslocamento horizontal de tarefas das bordas esquerda e direita dos grupos pai.
CMFCTasksPane::SetVertMargin	Define o espaçamento vertical entre um painel de tarefas e as bordas da área cliente.
CMFCTasksPane::SetWindowHeight	Defina a altura de uma janela.
CMFCTasksPane::ShowCommandMessageString
CMFCTasksPane::ShowTask	Mostra ou oculta uma tarefa.
CMFCTasksPane::ShowTaskByCmdId	Mostra ou oculta uma tarefa baseado em sua ID de comando
CMFCTasksPane::Update	Atualiza os elementos de GUI que pertencem a um painel de tarefas.

Métodos protegidos

Nome	Descrição
CMFCTasksPane::OnActivateTasksPanePage	Chamado pela estrutura quando uma nova página do painel de tarefas é ativada.

Comentários

a classe de CMFCTasksPane implementa a seguinte funcionalidade:

Itens podem ser agrupados e agrupamento de cada item pode ter uma legenda associado.
Os agrupamentos de item podem ser expandidos ou recolhidos.
Um ícone pode ser atribuído a cada item no painel de tarefas.
Os itens individuais podem ser associados com uma identificação de comando que executa quando um usuário clica em um item. Quando o clique ocorre, a mensagem de WM_COMMAND é enviada para o proprietário do controle do painel de tarefas.

Para usar CMFCTasksPane controle em seu aplicativo, siga estas etapas:

Inserir um objeto de CMFCTasksPane na classe de janela do quadro chave.
A o processar a mensagem de WM_CREATE , chame o método de Create . Você pode usar os estilos normais de CControlBar . Para mais informações, consulte CControlBar::Create.
Chame o método de CMFCTasksPane::AddGroup para adicionar vários grupos.
Chamar funções de membro de CMFCTasksPane::AddTask, de CMFCTasksPane::AddLabel ou de CMFCTasksPane::AddMRUFilesList para adicionar novos itens (tarefas) para cada grupo.
Chame CMFCTasksPane::EnableGroupCollapse para especificar se os grupos de item podem recolher.

A ilustração a seguir mostra um controle típico do painel de tarefas. O primeiro grupo é um grupo especiais e sua legenda é uma cor mais escura. o terceiro grupo é recolhido. O último grupo é alinhado à parte inferior do painel de tarefas e não tem nenhuma legenda, e a última tarefa no grupo é um rótulo simples:

Exemplo de painel de tarefas

Você pode personalizar a aparência do painel de várias tarefas ajustando as margens e deslocamentos. A ilustração a seguir para o significado de essas variáveis:

Grupo de tarefas personalizado

Exemplo

O exemplo a seguir demonstra como criar um objeto de CMFCTasksPane e para usar vários métodos em CMFCTasksPane classe. O exemplo a seguir mostra como ativar recolher de grupos de trabalho, permite que os menus suspensos nos botões de navegação de Avançar e de Anterior , permite que os botões de rolagem em vez de uma barra de rolagem, permite que a palavra que envolvem para o texto nos rótulos, define o nome da legenda do painel de tarefas, define a cor do texto para uma legenda do grupo, e defina as margens horizontais e verticais.

   CMFCTasksPane* tPane = new CMFCTasksPane();
    tPane->EnableGroupCollapse(true);
    tPane->EnableHistoryMenuButtons(true);
    tPane->EnableScrollButtons(true);
    tPane->EnableWrapLabels(true);
    tPane->SetCaption(_T("Task Pane"));
    tPane->SetGroupTextColor(0,RGB(0,0,128));
    tPane->SetHorzMargin(15);
    tPane->SetVertMargin(15);
    tPane->Update();