CMFCTasksPane Class

Artículo
06/10/2015

Este tema se incluye a efectos de integridad. Para obtener información más detallada, consulta 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

Constructores públicos

Name	Descripción
CMFCTasksPane::CMFCTasksPane	Crea un objeto CMFCTasksPane.

Mé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::Serialize.)
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.

Mé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:

Inserte un objeto de CMFCTasksPane en la clase de ventana de marco principal.
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.
Llame al método de CMFCTasksPane::AddGroup para agregar los grupos diferentes.
Llame a las funciones miembro de CMFCTasksPane::AddTask, de CMFCTasksPane::AddLabel o de CMFCTasksPane::AddMRUFilesList para agregar nuevos elementos (tareas) a cada grupo.
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();