CMFCTabCtrl Class

Artículo
06/10/2015

La clase de CMFCTabCtrl proporciona funcionalidad para un control de ficha. El control de ficha muestra una ventana acoplable con pestañas planas o tridimensionales en la parte superior o inferior. Las fichas pueden mostrar texto y una imagen y pueden cambiar color cuando está activo.

class CMFCTabCtrl : public CMFCBaseTabCtrl

Members

Constructores públicos

Name	Descripción
CMFCTabCtrl::CMFCTabCtrl	Constructor predeterminado.
CMFCTabCtrl::~CMFCTabCtrl	Un destructor.

Métodos públicos

Name	Descripción
CMFCTabCtrl::ActivateMDITab	Muestra la ficha especificada del control de tabulación y establece el foco en esa ficha.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow	Especifica si el marco es cambiar el tamaño del área cliente de todas las ventanas de control de ficha cuando un elemento de la interfaz de usuario del control cambia de la pestaña.
CMFCTabCtrl::CalcRectEdit	Desinfla el tamaño del área especificada de la pestaña. (Reemplaza CMFCBaseTabCtrl::CalcRectEdit.)
CMFCTabCtrl::Create	Crear el control de ficha y lo asocia al objeto de CMFCTabCtrl .
CMFCTabCtrl::CreateObject	Utiliza el marco para crear una instancia dinámica de este tipo de clase.
CMFCTabCtrl::EnableActiveTabCloseButton	Muestra u oculta un botón cerrar (x) en la pestaña activa.
CMFCTabCtrl::EnableInPlaceEdit	Habilita o deshabilita etiquetas editable de la pestaña. (Reemplaza CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu	Reemplaza dos botones que desplacen las fichas de la ventana con un botón que abre un menú de ventanas con fichas.
CMFCTabCtrl::EnsureVisible	Garantiza que una ficha esté visible.
CMFCTabCtrl::GetDocumentIcon	Recupera el símbolo que se está asociado a una ficha en un menú emergente de ventanas con fichas.
CMFCTabCtrl::GetFirstVisibleTabNum	Recupera el índice de la primera pestaña que está visible en el control de tabulación.
CMFCTabCtrl::GetResizeMode	Recupera un valor que especifica cómo el control de tabulación puede cambiar de tamaño.
CMFCTabCtrl::GetScrollBar	Recupera un puntero al objeto de la barra de desplazamiento que está asociado al control de ficha.
CMFCTabCtrl::GetTabArea	Recupera el rectángulo delimitador de la etiqueta de la ficha en la parte superior o inferior del control de ficha. (Reemplaza CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint	Recupera la pestaña que contiene un punto especificado. (Reemplaza CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth	Recupera el ancho máximo de una pestaña.
CMFCTabCtrl::GetTabsHeight	Recupera el alto de la pestaña de control de tabulación.
CMFCTabCtrl::GetTabsRect	Recupera un rectángulo que restringe el área de la pestaña de control de tabulación. (Reemplaza CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass	Utiliza el marco para obtener un puntero al objeto de Recursos que está asociado a este tipo de clase.
CMFCTabCtrl::GetWndArea	Recupera el límite del área de cliente del control de tabulación.
CMFCTabCtrl::HideActiveWindowHorzScrollBar	Oculta la barra de desplazamiento horizontal, si existe, la ventana activa.
CMFCTabCtrl::HideInactiveWindow	Especifica si el marco es mostrar ventanas de control inactivas de la pestaña.
CMFCTabCtrl::HideNoTabs	Habilita o deshabilita el dibujo del área de la pestaña si no hay pestañas visible.
CMFCTabCtrl::HideSingleTab	Habilita o deshabilita la creación de una pestaña cuando hay una sola ventana con fichas. (Reemplaza CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup	Indica si la ficha actual de un control de ficha es la ficha activa en un grupo de la ficha de la interfaz de múltiples documentos.
CMFCTabCtrl::IsActiveTabBoldFont	Indica si el texto de la pestaña activa se muestra con una fuente en negrita.
CMFCTabCtrl::IsActiveTabCloseButton	Indica si el botón cerrar (x) se muestra en una pestaña activa o la esquina superior derecha del área de la ficha.
CMFCTabCtrl::IsDrawFrame	Indica si la ventana con fichas dibuja un rectángulo de cuadro alrededor de los paneles incrustados.
CMFCTabCtrl::IsFlatFrame	Indica si el cuadro alrededor del área de la ficha es plano o 3D.
CMFCTabCtrl::IsFlatTab	Indica si la apariencia de fichas en el control de tabulación es plano o no.
CMFCTabCtrl::IsLeftRightRounded	Indica si el aspecto del lado izquierdo y derecho de una pestaña del control de tabulación está redondeado.
CMFCTabCtrl::IsMDITabGroup	Indica si el control de tabulación está contenido en el área cliente de una ventana de interfaz de múltiples documentos.
CMFCTabCtrl::IsOneNoteStyle	Indica si el control de tabulación se muestra en el estilo de Microsoft OneNote.
CMFCTabCtrl::IsPtInTabArea	Determina si un punto está dentro del área de la ficha. (Reemplaza CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll	Indica si el control de tabulación tiene una barra de desplazamiento que pueda desplazarse sus pestañas como grupo.
CMFCTabCtrl::IsTabDocumentsMenu	Indica si el control de ficha muestra botones de desplazamiento o un botón que muestra un menú de ventanas con fichas.
CMFCTabCtrl::IsVS2005Style	Indica si las fichas aparecen en el estilo Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyle	Especifica la apariencia de fichas del control de tabulación.
CMFCTabCtrl::MoveTab	Mueve una pestaña a otra posición de pestaña. (Reemplaza CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter	Llamado por el marco cuando el cursor primero se arrastra en la ventana de control de ficha.
CMFCTabCtrl::OnDragOver	Llamado por el marco durante una operación de arrastre cuando el mouse se mueve sobre la ventana de destino. (Reemplaza CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu	Muestra un menú emergente de ventanas con fichas, espera hasta que el usuario seleccione una ficha, y hace que la ficha seleccionada la pestaña activa.
CMFCTabCtrl::PreTranslateMessage	Traduce mensajes de ventana antes de que se envíen a las funciones de TranslateMessage y de DispatchMessage Windows. (Reemplaza CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout	Actualiza el diseño interno del control de ficha. (Reemplaza CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup	Establece la ficha actual de un control de ficha como la pestaña activa en un grupo de la ficha de la interfaz de múltiples documentos.
CMFCTabCtrl::SetActiveTab	Provoca una pestaña. (Reemplaza CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont	Habilita o deshabilita el uso de una fuente negrita en fichas activo.
CMFCTabCtrl::SetDrawFrame	Habilita o deshabilita el rectángulo del cuadro de drawinga alrededor de una barra incrustada.
CMFCTabCtrl::SetFlatFrame	Especifica si dibujar un plano o cuadro 3D alrededor del área de la ficha.
CMFCTabCtrl::SetImageList	Especifica una lista de imágenes. (Reemplaza CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode	Especifica cómo el control de tabulación puede cambiar de tamaño y después vuelve a mostrar el control.
CMFCTabCtrl::SetTabMaxWidth	Especifica el ancho máximo de la pestaña en una ventana con fichas.
CMFCTabCtrl::StopResize	Finaliza la ejecución cambian el tamaño de la operación en el control de ficha.
CMFCTabCtrl::SwapTabs	Cambia un par de fichas. (Reemplaza CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar	Dibuja una barra de desplazamiento horizontal en un control de ficha que muestra las fichas planas.

miembros de datos

Name	Descripción
CMFCTabCtrl::m_bEnableActivate	Evita la vista activa de foco se ejecuta cuando se insertan y se habilita una nueva pestaña.

Comentarios

la clase de CMFCTabCtrl admite:

Estilos de control tab que incluyen 3D, plano, y totalmente con una barra de desplazamiento horizontal compartida.
Fichas situadas en la parte superior o inferior de la ventana.
Fichas que muestran texto, imágenes, como texto e imágenes.
Fichas que cambian de color cuando la ficha está activa.
Cambios de tamaño del borde de las pestañas ajustables.
Ventanas con fichas desmontables.

La clase de CMFCTabCtrl se puede utilizar con un cuadro de diálogo, pero está pensado para las aplicaciones que utilizan acoplar barras de controles como Microsoft Excel y Visual Studio. Para obtener más información, vea CDockablePane (Clase).

Siga estos pasos para agregar un de tamaño variable, acoplar el control de ficha en la aplicación:

Cree una instancia de CTabbedPane (Clase).
Llamar a CDockablePane::Create.
Utilice CBaseTabbedPane::AddTab o CMFCBaseTabCtrl::InsertTab para agregar nuevas pestañas.
Llame a CBasePane::EnableDocking de modo que el control de tabulación de acoplamiento puede acoplar en la ventana de marco principal.
Llame a CFrameWndEx::DockPane para acoplar la ventana en la cuadro principal.

Para obtener un ejemplo de cómo crear una ventana con fichas como barra de control de acoplamiento, vea CTabbedPane (Clase). Para utilizar CMFCTabCtrl como control de no-muelle, cree un objeto de CMFCTabCtrl y llame a CMFCTabCtrl::Create.

Jerarquía de herencia

Ejemplo

El ejemplo siguiente se muestra cómo utilizar varios métodos en la clase de CMFCTabCtrl para configurar un objeto de CMFCTabCtrl . El ejemplo explica cómo agregar una pestaña, mostrar el botón cerrar en la pestaña activa, permite etiquetas editable de la ficha, y muestra un menú emergente de las etiquetas de ventana con fichas. Este ejemplo forma parte de Ejemplo de colección de estado.

 CMFCTabCtrl m_wndTabs;


...


    // Attach list windows to tab: 
    // CListCtrl m_wndList1 
    // CListCtrl m_wndList2 
    // CListCtrl m_wndList3
    m_wndTabs.AddTab (&m_wndList1, _T("Output 1"), (UINT)-1);
    m_wndTabs.AddTab (&m_wndList2, _T("Output 2"), (UINT)-1);
    m_wndTabs.AddTab (&m_wndList3, _T("Output 3"), (UINT)-1);

    m_wndTabs.EnableActiveTabCloseButton();
    m_wndTabs.EnableInPlaceEdit(true);
    m_wndTabs.EnableTabDocumentsMenu();
    m_wndTabs.SetActiveTab(1);
    m_wndTabs.SetDrawFrame();
    m_wndTabs.SetFlatFrame();