Compartir a través de


Clase de CMFCTasksPane

Este tema se incluye a efectos de integridad. Para obtener información más detallada, vea el código fuente ubicado en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

La clase de CMFCTasksPane implementa una lista de elementos seleccionables (tareas).

class CMFCTasksPane : public CDockablePane

Members

Bb984027.collapse_all(es-es,VS.110).gifConstructores públicos

Name

Descripción

CMFCTasksPane::CMFCTasksPane

Crea un objeto CMFCTasksPane.

Bb984027.collapse_all(es-es,VS.110).gifMétodos públicos

Name

Descripción

CMFCTasksPane::AddGroup

Agrega un nuevo grupo de tareas al control del panel de tareas.

CMFCTasksPane::AddLabel

agrega una nueva etiqueta estática en el grupo de tarea especificada.

CMFCTasksPane::AddMRUFilesList

Agrega las tareas especificadas por una lista de archivos utilizados (MRU) Más Recientemente en un grupo.

CMFCTasksPane::AddPage

Agrega una nueva página al panel de tareas.

CMFCTasksPane::AddSeparator

 

CMFCTasksPane::AddTask

Agrega una nueva tarea al grupo de tarea especificada.

CMFCTasksPane::AddWindow

Agrega una ventana secundaria al panel de tareas.

CMFCTasksPane::CollapseAllGroups

 

CMFCTasksPane::CollapseGroup

Mediante programación contrae un grupo.

CMFCTasksPane::CreateDefaultMiniframe

  (Reemplaza CPane::CreateDefaultMiniframe.)

CMFCTasksPane::CreateMenu

Llamado por el marco para crear un menú para el botón de menú de Otros paneles de tareas .

CMFCTasksPane::EnableAnimation

Habilita o deshabilita la animación mientras contrae o los grupos de tareas que expanden.

CMFCTasksPane::EnableGroupCollapse

Especifica si los grupos de tareas pueden contraerse.

CMFCTasksPane::EnableHistoryMenuButtons

Habilita o deshabilita menús desplegables en los botones de navegación de Siguiente y de Anterior .

CMFCTasksPane::EnableNavigationToolbar

Habilita o deshabilita la barra de herramientas de navegación.

CMFCTasksPane::EnableOffsetCustomControls

 

CMFCTasksPane::EnableScrollButtons

Habilita los botones de desplazamiento en lugar de una barra de desplazamiento.

CMFCTasksPane::EnableWrapLabels

Habilita o deshabilita el ajuste automático de línea para las etiquetas.

CMFCTasksPane::EnableWrapTasks

Habilita o deshabilita el ajuste automático de línea para las tareas.

CMFCTasksPane::GetActivePage

Devuelve el índice de base cero para la página activa.

CMFCTasksPane::GetGroupCaptionHeight

Devuelve el alto de las leyendas de grupo.

CMFCTasksPane::GetGroupCaptionHorzOffset

Devuelve la diferencia actual de una leyenda de grupo de los bordes izquierdo y derecho del panel de tareas.

CMFCTasksPane::GetGroupCaptionVertOffset

Devuelve la diferencia actual de una leyenda del grupo de la los bordes superior e inferior del panel de tareas.

CMFCTasksPane::GetGroupCount

Devuelve el número total de grupos.

CMFCTasksPane::GetGroupLocation

Devuelve el índice de grupo interno para un determinado grupo.

CMFCTasksPane::GetGroupVertOffset

devuelve el desplazamiento vertical de un grupo.

CMFCTasksPane::GetHorzMargin

Devuelve el espaciado horizontal entre un panel de tareas y los bordes del área de cliente.

CMFCTasksPane::GetNextPages

 

CMFCTasksPane::GetPageByGroup

Recupera el índice de página para un grupo especificado.

CMFCTasksPane::GetPagesCount

devuelve el número de páginas.

CMFCTasksPane::GetPreviousPages

 

CMFCTasksPane::GetScrollBarCtrl

  (Reemplaza CWnd::GetScrollBarCtrl.)

CMFCTasksPane::GetTask

recupera una tarea.

CMFCTasksPane::GetTaskCount

devuelve el número de elementos de tarea en un grupo especificado.

CMFCTasksPane::GetTaskGroup

Devuelve un grupo de tareas para un índice de grupo determinado.

CMFCTasksPane::GetTaskLocation

Devuelve el grupo y el índice para una tarea determinada.

CMFCTasksPane::GetTasksHorzOffset

Devuelve el desplazamiento horizontal de tareas de los bordes izquierdo y derecho de los grupos primarios.

CMFCTasksPane::GetTasksIconHorzOffset

 

CMFCTasksPane::GetTasksIconVertOffset

 

CMFCTasksPane::GetVertMargin

Devuelve el espaciado vertical entre un panel de tareas y los bordes del área de cliente.

CMFCTasksPane::IsAccessibilityCompatible

  (Reemplaza CDockablePane::IsAccessibilityCompatible.)

CMFCTasksPane::IsAnimationEnabled

indica si la animación está habilitada.

CMFCTasksPane::IsBackButtonEnabled

Indica si el botón atrás está habilitado.

CMFCTasksPane::IsForwardButtonEnabled

Indica si el botón hacia delante está habilitado.

CMFCTasksPane::IsGroupCollapseEnabled

 

CMFCTasksPane::IsHistoryMenuButtonsEnabled

indica si los botones de desplazamiento de Siguiente y de Anterior tienen menús desplegables.

CMFCTasksPane::IsNavigationToolbarEnabled

Indica si la barra de herramientas de navegación está habilitada.

CMFCTasksPane::IsToolBox

 

CMFCTasksPane::IsWrapLabelsEnabled

Indica si el panel de tareas contiene palabras en etiquetas.

CMFCTasksPane::IsWrapTasksEnabled

Indica si el panel de tareas contiene palabras en tareas.

CMFCTasksPane::LoadState

  (Reemplaza CDockablePane:: LoadState.)

CMFCTasksPane::OnCancel

 

CMFCTasksPane::OnClickTask

Llamado por el marco cuando el usuario hace clic en un elemento del panel de tareas.

CMFCTasksPane::OnOK

 

CMFCTasksPane::OnPressBackButton

Llamado por el marco cuando el usuario hace clic en el botón atrás.

CMFCTasksPane::OnPressForwardButton

Llamado por el marco cuando el usuario hace clic en el botón de desplazamiento hacia delante.

CMFCTasksPane::OnPressHomeButton

Llamado por el marco cuando el usuario hace clic en el botón de navegación home

CMFCTasksPane::OnPressOtherButton

 

CMFCTasksPane::OnSetAccData

  (Reemplaza CBasePane::OnSetAccData.)

CMFCTasksPane::OnUpdateCmdUI

  (Reemplaza CDockablePane:: OnUpdateCmdUI.)

CMFCTasksPane::PreTranslateMessage

  (Reemplaza CDockablePane:: PreTranslateMessage.)

CMFCTasksPane::RecalcLayout

  (Reemplaza CPane::RecalcLayout.)

CMFCTasksPane::RemoveAllGroups

Quita todos los grupos de la página especificada.

CMFCTasksPane::RemoveAllPages

Quita todas las páginas del panel de tareas excepto (la primera) página predeterminada.

CMFCTasksPane::RemoveAllTasks

Quita todas las tareas del grupo.

CMFCTasksPane::RemoveGroup

Quita un grupo.

CMFCTasksPane::RemovePage

Quita una página concreta del panel de tareas.

CMFCTasksPane::RemoveTask

quita una tarea de un grupo de tareas.

CMFCTasksPane::SaveState

  (Reemplaza CDockablePane:: SaveState.)

CMFCTasksPane::Serialize

  (Reemplaza CDockablePane:: serialice.)

CMFCTasksPane::SetActivePage

Provoca una página especificada en el panel de tareas.

CMFCTasksPane::SetCaption

Establece el nombre de la leyenda de un panel de tareas.

CMFCTasksPane::SetGroupCaptionHeight

Establece el alto de una leyenda de grupo.

CMFCTasksPane::SetGroupCaptionHorzOffset

Establece el desplazamiento horizontal de una leyenda de grupo.

CMFCTasksPane::SetGroupCaptionVertOffset

Establece el desplazamiento vertical de una leyenda de grupo.

CMFCTasksPane::SetGroupName

establece un nombre de grupo.

CMFCTasksPane::SetGroupTextColor

Establece el color del texto a una leyenda de grupo.

CMFCTasksPane::SetGroupVertOffset

establece el desplazamiento vertical para un grupo.

CMFCTasksPane::SetHorzMargin

Establece el espaciado horizontal entre un panel de tareas y los bordes del área de cliente.

CMFCTasksPane::SetIconsList

establece el asociado enumerado imagen con tareas.

CMFCTasksPane::SetPageCaption

Establece el texto del título de una página del panel de tareas.

CMFCTasksPane::SetTaskName

Establece el nombre de una tarea.

CMFCTasksPane::SetTasksIconHorzOffset

 

CMFCTasksPane::SetTasksIconVertOffset

 

CMFCTasksPane::SetTaskTextColor

Establece el color del texto a una tarea.

CMFCTasksPane::SetTasksHorzOffset

Establece el desplazamiento horizontal de tareas de los bordes izquierdo y derecho de los grupos primarios.

CMFCTasksPane::SetVertMargin

Establece el espaciado vertical entre un panel de tareas y los bordes del área de cliente.

CMFCTasksPane::SetWindowHeight

Establece el alto de una ventana.

CMFCTasksPane::ShowCommandMessageString

 

CMFCTasksPane::ShowTask

Muestra u oculta una tarea.

CMFCTasksPane::ShowTaskByCmdId

Muestra u oculta una tarea basada en el identificador de comando

CMFCTasksPane::Update

actualiza los elementos de GUI que pertenecen a un panel de tareas.

Bb984027.collapse_all(es-es,VS.110).gifMétodos protegidos

Name

Descripción

CMFCTasksPane::OnActivateTasksPanePage

Llamado por el marco cuando se inicia una nueva página del panel de tareas.

Comentarios

La clase de CMFCTasksPane implementa la siguiente funcionalidad:

  • Los elementos pueden ser agrupados y cada agrupación de elementos puede tener una leyenda asociado.

  • Las agrupaciones de elemento pueden ser contraídas o ser expandidas.

  • Un icono se puede asignar a cada elemento del panel de tareas.

  • Los elementos individuales pueden estar asociado a un identificador de comando que se ejecuta cuando un usuario hace clic en el elemento.Cuando haga clic en, aparece el mensaje de WM_COMMAND se envía al propietario del control del panel de tareas.

para utilizar el control de CMFCTasksPane en la aplicación, siga estos pasos:

  1. Inserte un objeto de CMFCTasksPane en la clase de ventana de marco principal.

  2. Al procesar el mensaje de WM_CREATE , llame al método de Create .Puede utilizar los estilos normales de CControlBar .Para obtener más información, vea CControlBar::Create.

  3. Llame al método de CMFCTasksPane::AddGroup para agregar los grupos diferentes.

  4. Llame a las funciones miembro de CMFCTasksPane::AddTask, de CMFCTasksPane::AddLabel o de CMFCTasksPane::AddMRUFilesList para agregar nuevos elementos (tareas) a cada grupo.

  5. Llame a CMFCTasksPane::EnableGroupCollapse para especificar si los grupos de elementos pueden contraer.

La ilustración siguiente se muestra un control típico del panel de tareas.El primer grupo es un grupo especial y su leyenda es color más oscuro.el tercer grupo está contraído.El último grupo está alineado a la parte inferior del panel de tareas y no tiene ningún leyenda, y la tarea pasada al grupo es una etiqueta simple:

Ejemplo de panel de tareas

Puede personalizar la apariencia del panel de tareas ajustando los márgenes y desplazamientos.La ilustración siguiente explica el significado de estas variables:

Grupo de tareas personalizado

Ejemplo

El ejemplo siguiente muestra cómo construir un objeto de CMFCTasksPane y utilizar varios métodos en la clase de CMFCTasksPane .El ejemplo muestra cómo habilitar contraer grupos de tareas, habilitar los menús desplegables en los botones de navegación de Siguiente y de Anterior , habilitar los botones de desplazamiento en lugar de una barra de desplazamiento, permite el ajuste de línea del texto de etiquetas, establece el nombre de la leyenda del panel de tareas, establezca el color del texto para una leyenda de grupo, y establezca los márgenes horizontal y vertical.

    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();

Jerarquía de herencia

CObjectCCmdTargetCWnd

         CBasePaneCPaneCDockablePane

                  CMFCTasksPane

Requisitos

encabezado: afxTasksPane.h

Vea también

Referencia

Gráfico de jerarquía

Clase de CMFCTasksPaneTaskGroup

Clase de CMFCTasksPaneTask

Clase de CMFCOutlookBar

Clase de CMFCVisualManager

Otros recursos

Clases de MFC