Compartir a través de

Clase CMFCTabCtrl

  • Artículo

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

Sintaxis

class CMFCTabCtrl : public CMFCBaseTabCtrl

Miembros

Constructores públicos

Nombre Descripción
CMFCTabCtrl::CMFCTabCtrl Constructor predeterminado.
CMFCTabCtrl::~CMFCTabCtrl Destructor.

Métodos públicos

Nombre Descripción
CMFCTabCtrl::ActivateMDITab Muestra la pestaña especificada del control de pestaña actual y establece el foco en esa pestaña.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow Especifica si el marco de trabajo cambia el tamaño del área cliente de todas las ventanas de control de pestaña cuando cambia un elemento de interfaz de usuario del control de ficha.
CMFCTabCtrl::CalcRectEdit Reduce el tamaño del área de la pestaña especificada. (Invalida CMFCBaseTabCtrl::CalcRectEdit).
CMFCTabCtrl::Create Crea el control de pestañas y lo adjunta al objeto CMFCTabCtrl.
CMFCTabCtrl::CreateObject Usado por el marco de trabajo 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 Activa o desactiva las etiquetas editables de las pestañas. (Invalida CMFCBaseTabCtrl::EnableInPlaceEdit).
CMFCTabCtrl::EnableTabDocumentsMenu Reemplaza dos botones que desplazan las pestañas de la ventana por un botón que abre un menú de ventanas con pestañas.
CMFCTabCtrl::EnsureVisible Garantiza que una pestaña esté visible.
CMFCTabCtrl::GetDocumentIcon Recupera el símbolo asociado a una pestaña en un menú emergente de ventanas con pestañas.
CMFCTabCtrl::GetFirstVisibleTabNum Recupera el índice de la primera pestaña que está visible en el control de ficha actual.
CMFCTabCtrl::GetResizeMode Recupera un valor que especifica cómo se puede cambiar el tamaño del control de ficha actual.
CMFCTabCtrl::GetScrollBar Recupera un puntero al objeto de barra de desplazamiento asociado al control de ficha.
CMFCTabCtrl::GetTabArea Recupera el rectángulo delimitador del área de etiqueta de tabulación en la parte superior o inferior del control de ficha. (Invalida CMFCBaseTabCtrl::GetTabArea).
CMFCTabCtrl::GetTabFromPoint Recupera la pestaña que contenga un punto especificado. (Invalida CMFCBaseTabCtrl::GetTabFromPoint).
CMFCTabCtrl::GetTabMaxWidth Recupera el ancho máximo de una pestaña.
CMFCTabCtrl::GetTabsHeight Recupera el alto del área de tabulación del control de ficha actual.
CMFCTabCtrl::GetTabsRect Recupera un rectángulo que enlaza el área de tabulación del control de ficha actual. (Invalida CMFCBaseTabCtrl::GetTabsRect).
CMFCTabCtrl::GetThisClass El marco de trabajo usa este elemento para obtener un puntero al objeto CRuntimeClass asociado a este tipo de clase.
CMFCTabCtrl::GetWndArea Recupera el límite del área de cliente del control de pestaña actual.
CMFCTabCtrl::HideActiveWindowHorzScrollBar Oculta la barra de desplazamiento horizontal, si existe, de la ventana activa.
CMFCTabCtrl::HideInactiveWindow Especifica si el marco de trabajo debe mostrar ventanas de control de tabulación inactivas.
CMFCTabCtrl::HideNoTabs Habilita o deshabilita el dibujo del área de tabulación si no hay pestañas visibles.
CMFCTabCtrl::HideSingleTab Habilita o deshabilita el dibujo de una pestaña cuando hay una sola ventana con pestañas. (Invalida CMFCBaseTabCtrl::HideSingleTab).
CMFCTabCtrl::IsActiveInMDITabGroup Indica si la pestaña actual de un control de ficha es la pestaña activa en un grupo de pestañas de interfaz de documento múltiple.
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 en la esquina superior derecha del área de tabulación.
CMFCTabCtrl::IsDrawFrame Indica si la ventana con pestañas dibuja un rectángulo de marco alrededor de los paneles incrustados.
CMFCTabCtrl::IsFlatFrame Indica si el formato del marco del área de pestañas es plano o en 3D.
CMFCTabCtrl::IsFlatTab Indica si la apariencia de las pestañas en el control de ficha actual es plana o no.
CMFCTabCtrl::IsLeftRightRounded Indica si la apariencia del lado izquierdo y derecho de una ficha del control de ficha actual se redondea.
CMFCTabCtrl::IsMDITabGroup Indica si el control de ficha actual está contenido en el área cliente de una ventana de interfaz de varios documentos.
CMFCTabCtrl::IsOneNoteStyle Indica si el control de ficha actual se muestra en el estilo de Microsoft OneNote.
CMFCTabCtrl::IsPtInTabArea Determina si un punto está dentro del área de pestaña. (Invalida CMFCBaseTabCtrl::IsPtInTabArea).
CMFCTabCtrl::IsSharedScroll Indica si el control de pestaña actual tiene una barra de desplazamiento que puede desplazar sus pestañas como un grupo.
CMFCTabCtrl::IsTabDocumentsMenu Indica si el control de ficha muestra botones de desplazamiento o un botón que muestra un menú de ventanas con pestañas.
CMFCTabCtrl::IsVS2005Style Indica si las pestañas se muestran en el estilo de Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyle Especifica la apariencia de las pestañas en el control de pestañas actual.
CMFCTabCtrl::MoveTab Mueve una pestaña a otra posición de tabulación. (Invalida CMFCBaseTabCtrl::MoveTab).
CMFCTabCtrl::OnDragEnter Llamado por el framework cuando el cursor es arrastrado por primera vez a la ventana de control de pestañas.
CMFCTabCtrl::OnDragOver Lo llama el marco durante una operación de arrastre cuando el mouse se mueve sobre la ventana de destino de colocación. (Invalida CMFCBaseTabCtrl::OnDragOver).
CMFCTabCtrl::OnShowTabDocumentsMenu Muestra un menú emergente de ventanas con pestañas, espera hasta que el usuario selecciona una pestaña y hace que la pestaña seleccionada sea la pestaña activa.
CMFCTabCtrl::PreTranslateMessage Traslada los mensajes de la ventana antes de enviarlos a las funciones de Windows TranslateMessage y DispatchMessage. (Invalida CMFCBaseTabCtrl::PreTranslateMessage).
CMFCTabCtrl::RecalcLayout Vuelve a calcular el diseño interno del control de pestañas. (Invalida CMFCBaseTabCtrl::RecalcLayout).
CMFCTabCtrl::SetActiveInMDITabGroup Establece la pestaña actual de un control de pestañas como la pestaña activa en un grupo de pestañas de la interfaz de múltiples documentos.
CMFCTabCtrl::SetActiveTab Activa una pestaña. (Invalida CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont Habilita o deshabilita el uso de una fuente en negrita en pestañas activas.
CMFCTabCtrl::SetDrawFrame Habilita o deshabilita el dibujo de un rectángulo de marco alrededor de una barra incrustada.
CMFCTabCtrl::SetFlatFrame Especifica si se debe dibujar un marco plano o 3D alrededor del área de tabulación.
CMFCTabCtrl::SetImageList Especifica una lista de imagen. (Invalida CMFCBaseTabCtrl::SetImageList).
CMFCTabCtrl::SetResizeMode Especifica cómo se puede cambiar el tamaño del control de pestaña actual y, a continuación, vuelve a mostrar el control.
CMFCTabCtrl::SetTabMaxWidth Especifica el ancho máximo de tabulación en una ventana con pestañas.
CMFCTabCtrl::StopResize Finaliza la operación de cambio de tamaño actual en el control de ficha.
CMFCTabCtrl::SwapTabs Intercambia un par de pestañas. (Invalida CMFCBaseTabCtrl::SwapTabs).
CMFCTabCtrl::SynchronizeScrollBar Dibuja una barra de desplazamiento horizontal en un control de pestaña que muestra pestañas planas.

Miembros de datos

Nombre Descripción
CMFCTabCtrl::m_bEnableActivate Impide que la vista activa pierda el foco cuando se inserta y habilita una nueva pestaña.

Comentarios

La clase CMFCTabCtrl admite:

  • Estilos de pestaña de control que incluyen 3D, plano y plano con una barra de desplazamiento horizontal compartida.

  • Pestañas ubicadas en la parte superior o inferior de la ventana.

  • Pestañas que muestran texto, imágenes o texto e imágenes.

  • Pestañas que cambian de color cuando la pestaña está activa.

  • Cambia el tamaño del borde para pestañas ajustables.

  • Ventanas con pestañas separables.

La clase CMFCTabCtrl se puede usar con un cuadro de diálogo, pero está pensada para aplicaciones que usan barras de control de acoplamiento como Microsoft Excel y Visual Studio. Para obtener más información, consulte la CDockablePane clase.

Siga estos pasos para agregar un control de pestaña de acoplamiento y redimensionable en la aplicación:

  1. Crea una instancia de la CTabbedPane Clase.

  2. Llame a CDockablePane::Create.

  3. Usa CBaseTabbedPane::AddTab o CMFCBaseTabCtrl::InsertTab para agregar nuevas pestañas.

  4. Llama a CBasePane::EnableDocking para que el control de pestaña de acoplamiento actual pueda acoplarse en la ventana de marco principal.

  5. Llama CFrameWndEx::DockPane a para acoplar la ventana con pestañas en el marco principal.

Para obtener un ejemplo de cómo crear una ventana con pestañas como barra de control de acoplamiento, consulta CTabbedPane Clase. Para usar CMFCTabCtrl como control de no acoplamiento, crea un CMFCTabCtrl objeto y, a continuación, llama a CMFCTabCtrl::Create.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Ejemplo

En el ejemplo siguiente, se muestra cómo configurar un objeto CMFCTabCtrl mediante varios métodos de la clase CMFCTabCtrl. En el ejemplo se explica cómo agregar una pestaña, mostrar el botón Cerrar en la pestaña activa, habilitar etiquetas de pestaña editables y mostrar un menú emergente de etiquetas de ventana con pestañas. Este ejemplo forma parte del ejemplo de recopilación de estados.

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

Requisitos

Encabezado: afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

Muestra la pestaña especificada del control de pestaña actual y establece el foco en esa pestaña.

void ActivateMDITab(int nTab = -1);

Parámetros

nTab
[in] El índice de base cero de una pestaña que se va a mostrar o -1 para especificar la pestaña activa actualmente.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Para obtener información más detallada, consulte el código fuente ubicado en la carpeta mfc de la instalación de Visual Studio. Por ejemplo, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Valor devuelto

Siempre TRUE.

Comentarios

CMFCTabCtrl::AutoSizeWindow

Especifica si el marco de trabajo cambia el tamaño del área cliente de todas las ventanas de control de pestaña cuando cambia un elemento de interfaz de usuario del control de ficha.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Parámetros

bAutoSize
[in] TRUE para cambiar automáticamente el tamaño de las ventanas de control de tabulación; de lo contrario, FALSE. El valor predeterminado es TRUE.

Comentarios

CMFCTabCtrl::Create

Crea el control de pestañas y lo adjunta al objeto CMFCTabCtrl.

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

Parámetros

style
[in] El estilo del control de pestaña. Para obtener más información, vea la sección Comentarios.

rect
[in] Un rectángulo que enlaza con el control de pestaña.

pParentWnd
[in] Un puntero a una ventana primaria. No debe ser NULL.

nID
[in] El identificador del control de pestaña.

location
[in] La ubicación de las pestañas. El valor predeterminado es LOCATION_BOTTOM. Para obtener más información, vea Comentarios.

bCloseBtn
[in] TRUE para mostrar un botón cerrar en la pestaña; de lo contrario, FALSE. El valor predeterminado es FALSE.

Valor devuelto

TRUE, si es correcto; en caso contrario, FALSE.

Comentarios

En la tabla siguiente se describen los valores que se pueden especificar en el parámetro style.

Estilo Descripción
STYLE_3D Crea un control de pestaña con una apariencia tridimensional.
STYLE_FLAT Crea un control de pestaña con pestañas planas.
STYLE_FLAT_SHARED_HORZ_SCROLL Crea un control de pestaña con pestañas planas y una barra de desplazamiento que puede desplazar las pestañas si se recortan mediante una ventana primaria.
STYLE_3D_ONENOTE Crea un control de pestaña en el estilo de Microsoft OneNote.
STYLE_3D_VS2005 Crea un control de pestaña con el estilo de Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED Crea un control de pestaña con pestañas redondeadas con el estilo de Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLL Crea un control de pestaña con pestañas redondeadas y botones de desplazamiento con el estilo de Microsoft Visual Studio 2005.

En la tabla siguiente se enumeran los valores que se pueden especificar en el parámetro location.

Location Descripción
LOCATION_BOTTOM Las pestañas se encuentran en la parte inferior del control de pestaña.
LOCATION_TOP Las pestañas se encuentran en la parte superior del control de pestaña.

Ejemplo

El siguiente ejemplo muestra cómo se usa el método Create de la clase CMFCTabCtrl. Este ejemplo forma parte del ejemplo de recopilación de estados.

CMFCTabCtrl m_wndTabs;

// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

CMFCTabCtrl::CalcRectEdit

Reduce el tamaño del área de la pestaña especificada.

virtual void CalcRectEdit(CRect& rectEdit);

Parámetros

rectEdit
[in] Un rectángulo que especifica el área de una pestaña.

Comentarios

Este método es llamado cuando se cambia la etiqueta de una pestaña. Este método desinfla los lados izquierdo y derecho del rectángulo especificado en la mitad de la altura actual de la pestaña, y desinfla la parte superior e inferior en una unidad.

CMFCTabCtrl::EnableActiveTabCloseButton

Muestra u oculta un botón Cerrar (X) en la pestaña activa.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Parámetros

bEnable
[in] TRUE para mostrar el botón Cerrar en la pestaña activa; FALSE para mostrar el botón Cerrar en la esquina superior derecha del área de fichas. El valor predeterminado es TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Activa o desactiva las etiquetas editables de las pestañas.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parámetros

bEnable
[in] TRUE para habilitar etiquetas de tabulación editables; FALSE para deshabilitar las etiquetas de pestaña editables.

Comentarios

CMFCTabCtrl::EnableTabDocumentsMenu

Alterna entre una interfaz de usuario que usa dos botones para desplazarse por las pestañas de ventana y una interfaz que muestra un menú emergente de ventanas con pestañas.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Parámetros

bEnable
[in] TRUE para mostrar un menú emergente de etiquetas de ventana con pestañas; FALSE para mostrar los botones de desplazamiento hacia delante y hacia atrás. El valor predeterminado es TRUE.

Comentarios

Cuando el usuario hace clic en una etiqueta de pestaña, el marco muestra la ventana con pestañas correspondiente. Si la etiqueta de pestaña está visible, la ventana con pestañas se abre sin cambiar su posición. Si el usuario selecciona un documento en el menú emergente y la ventana con pestañas correspondiente está fuera de la pantalla, la ventana con pestañas se convierte en la primera pestaña.

CMFCTabCtrl::EnsureVisible

Garantiza que una pestaña esté visible.

virtual BOOL EnsureVisible(int iTab);

Parámetros

iTab
[in] El índice de base cero de una pestaña.

Valor devuelto

TRUE si es correcto; FALSE si el índice del iTab parámetro no es válido.

Comentarios

Usa este método para garantizar que la pestaña especificada esté visible. El control de pestaña se desplazará si es necesario.

CMFCTabCtrl::GetDocumentIcon

Recupera la imagen asociada a una pestaña en un menú emergente de ventanas con pestañas.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Parámetros

nCmdID
[in] EL identificador de comando de una pestaña en un menú emergente de ventanas con pestañas.

Valor devuelto

El manipulador de una imagen de bits.

CMFCTabCtrl::GetFirstVisibleTabNum

Recupera el índice de la primera pestaña que está visible en el control de ficha actual.

virtual int GetFirstVisibleTabNum() const;

Valor devuelto

Índice de base cero de una pestaña en el control de pestaña.

Comentarios

Usa este método solo cuando el control de pestaña se muestre en el estilo de Microsoft OneNote. Usa el CMFCTabCtrl::IsOneNoteStyle método para determinar el estilo.

CMFCTabCtrl::GetResizeMode

Recupera un valor que especifica cómo se puede cambiar el tamaño del control de ficha actual.

ResizeMode GetResizeMode() const;

Valor devuelto

Uno de los CMFCTabCtrl::ResizeMode valores de enumeración que especifica cómo se puede cambiar el tamaño del control de tabulación. Para ver una lista de posibles valores, consulte la sección Observaciones del método CMFCTabCtrl::SetResizeMode.

CMFCTabCtrl::GetScrollBar

Recupera un puntero al objeto de barra de desplazamiento asociado al control de ficha.

CScrollBar* GetScrollBar();

Valor devuelto

Puntero a un objeto de barra de desplazamiento o si NULL un control de pestaña no se creó mediante el estilo STYLE_FLAT_SHARED_HORZ_SCROLL.

Comentarios

Usa este método para acceder a la barra de desplazamiento incrustada del control de pestañas. Solo se crea un objeto de barra de desplazamiento cuando el control de ficha tiene el estilo STYLE_FLAT_SHARED_HORZ_SCROLL.

CMFCTabCtrl::GetTabArea

Recupera el rectángulo delimitador del área de etiqueta de tabulación en la parte superior o inferior del control de ficha.

void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Parámetros

rectTabAreaTop
[out] Cuando este método devuelve, esta referencia contiene un rectángulo que enlaza el área de etiqueta de tabulación superior. El rectángulo está en coordenadas de cliente. Esta referencia está vacía si no existe ningún área de etiqueta de tabulación en la parte superior del control de ficha.

rectTabAreaBottom
[out] Cuando este método vuelve, esta referencia contiene un rectángulo que enlaza el área de etiqueta de ficha inferior. El rectángulo está en coordenadas de cliente. Esta referencia está vacía si no existe ningún área de etiqueta de tabulación en la parte inferior del control de ficha.

Comentarios

Utiliza este método para determinar el tamaño y la posición del área de tabulación en la ventana con pestañas.

CMFCTabCtrl::GetTabMaxWidth

Recupera el ancho máximo de una pestaña.

int GetTabMaxWidth() const;

Valor devuelto

Ancho máximo de una pestaña, en píxeles. Si el valor devuelto es 0, el ancho de tabulación es ilimitado.

Comentarios

Usa el método CMFCTabCtrl::SetTabMaxWidth para establecer el ancho máximo de tabulación.

CMFCTabCtrl::GetTabsHeight

Recupera el alto del área de tabulación del control de ficha actual.

virtual int GetTabsHeight() const;

Valor devuelto

La altura del área de tabulación si hay alguna pestaña visible o cero si no hay ninguna pestaña visible.

CMFCTabCtrl::GetTabsRect

Recupera un rectángulo que enlaza el área de tabulación del control de ficha actual.

virtual void GetTabsRect(CRect& rect) const;

Parámetros

rect
[out] Cuando este método devuelve, el parámetro rect contiene un rectángulo que enlaza el área de tabulación.

CMFCTabCtrl::GetWndArea

Recupera el límite del área de cliente del control de pestaña actual.

void GetWndArea(CRect& rect) const;

Parámetros

rect
[in, out] Cuando este método devuelve, este parámetro contiene un rectángulo que enlaza el control de ficha actual.

Comentarios

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Oculta la barra de desplazamiento horizontal, si existe, de la ventana activa.

void HideActiveWindowHorzScrollBar();

Comentarios

Use este método para evitar que el control de pestaña parpadee cuando el usuario cambie entre páginas de control de pestañas.

CMFCTabCtrl::HideInactiveWindow

Especifica si el marco de trabajo debe mostrar ventanas de control de tabulación inactivas.

void HideInactiveWindow(BOOL bHide = TRUE);

Parámetros

bHide
[in] TRUE no mostrar una ventana inactiva; FALSE para mostrar una ventana inactiva. El valor predeterminado es TRUE.

Comentarios

CMFCTabCtrl::HideNoTabs

Habilita o deshabilita el dibujo del área de tabulación si no hay pestañas visibles.

void HideNoTabs(BOOL bHide=TRUE);

Parámetros

bHide
[in] TRUE para habilitar el dibujo del área de tabulación; FALSE para deshabilitar el dibujo. El valor predeterminado es TRUE.

Comentarios

CMFCTabCtrl::HideSingleTab

Habilita o deshabilita el dibujo de pestañas si hay una sola ventana con pestañas.

virtual void HideSingleTab(BOOL bHide=TRUE);

Parámetros

bHide
[in] TRUE para no dibujar una pestaña para una sola ventana con pestañas; FALSE para dibujar una sola pestaña. El valor predeterminado es TRUE.

Comentarios

CMFCTabCtrl::IsActiveInMDITabGroup

Indica si la pestaña actual de un control de ficha es la pestaña activa en un grupo de pestañas de interfaz de documento múltiple.

BOOL IsActiveInMDITabGroup() const;

Valor devuelto

TRUE si la pestaña actual de un control de ficha es la pestaña activa en un grupo de fichas MDI; de lo contrario, FALSE.

Comentarios

Puede organizar varias ventanas de documento y ventanas de herramientas en grupos de pestañas horizontales o verticales e intercambiar documentos de un grupo a otro.

CMFCTabCtrl::IsActiveTabBoldFont

Indica si el texto de la pestaña activa se muestra con una fuente en negrita.

BOOL IsActiveTabBoldFont() const;

Valor devuelto

TRUE si se muestra la pestaña activa utilizando la fuente en negrita; de lo contrario, FALSE.

Comentarios

Usa el CMFCTabCtrl::SetActiveTabBoldFont método para cambiar la fuente de tabulación activa.

CMFCTabCtrl::IsActiveTabCloseButton

Indica si el botón Cerrar ( X) se muestra en una pestaña activa o en la esquina superior derecha del área de la pestaña.

virtual BOOL IsActiveTabCloseButton() const;

Valor devuelto

TRUE si el botón Cerrar se muestra en la pestaña activa; FALSE si el botón Cerrar se muestra en la esquina superior derecha del área de fichas.

Comentarios

CMFCTabCtrl::IsDrawFrame

Indica si la ventana con pestañas dibuja un rectángulo de marco alrededor de los paneles incrustados.

BOOL IsDrawFrame() const;

Valor devuelto

TRUE si se dibuja un rectángulo de marco; de lo contrario, FALSE.

Comentarios

Usa el CMFCTabCtrl::SetDrawFrame método para habilitar o deshabilitar el dibujo de un rectángulo de marco.

CMFCTabCtrl::IsFlatFrame

Indica si el formato del marco del área de pestañas es plano o en 3D.

BOOL IsFlatFrame() const;

Valor devuelto

TRUE si el marco alrededor del área de tabulación es plano; FALSE si el marco es tridimensional.

Comentarios

Usa el CMFCTabCtrl::SetFlatFrame método para cambiar cómo se dibuja el marco.

CMFCTabCtrl::IsFlatTab

Indica si la apariencia de las pestañas en el control de ficha actual es plana o no.

virtual BOOL IsFlatTab() const;

Valor devuelto

TRUE si la apariencia de las pestañas en el control de ficha actual es plana, de lo contrario, FALSE.

CMFCTabCtrl::IsLeftRightRounded

Indica si la apariencia del lado izquierdo y derecho de una ficha del control de ficha actual se redondea.

virtual BOOL IsLeftRightRounded() const;

Valor devuelto

TRUE si los lados de cada ficha se redondean; de lo contrario, FALSE.

CMFCTabCtrl::IsMDITabGroup

Indica si el control de ficha actual está contenido en el área cliente de una ventana de interfaz de varios documentos.

virtual BOOL IsMDITabGroup() const;

Valor devuelto

TRUE si el control de ficha actual está en una ventana de área de cliente MDI; de lo contrario, FALSE.

CMFCTabCtrl::IsOneNoteStyle

Indica si el control de ficha actual se muestra en el estilo de Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Valor devuelto

TRUE si el control de pestaña se muestra en el estilo de Microsoft OneNote; de lo contrario, FALSE.

CMFCTabCtrl::IsSharedScroll

Indica si el control de pestaña actual tiene una barra de desplazamiento que puede desplazar sus pestañas como un grupo.

BOOL IsSharedScroll() const;

Valor devuelto

TRUE si el control de ficha tiene una barra de desplazamiento compartida; de lo contrario, FALSE.

Comentarios

Este método devuelve TRUE si el style parámetro del CMFCTabCtrl::Create método es STYLE_FLAT_SHARED_HORZ_SCROLL.

CMFCTabCtrl::IsTabDocumentsMenu

Indica si el control de ficha muestra botones de desplazamiento o un botón que muestra un menú de ventanas con pestañas.

BOOL IsTabDocumentsMenu() const;

Valor devuelto

TRUE si las ventanas con pestañas se desplazan mediante un menú emergente de etiquetas de ventana con pestañas; FALSE si las ventanas con pestañas se desplazan con botones de desplazamiento hacia delante y hacia atrás.

Comentarios

Usa el CMFCTabCtrl::EnableTabDocumentsMenu método para especificar el método de desplazamiento de ventanas con pestañas.

CMFCTabCtrl::IsVS2005Style

Indica si las pestañas se dibujan con el estilo de Visual Studio 2005.

virtual BOOL IsVS2005Style() const;

Valor devuelto

TRUE si las pestañas se dibujan con el estilo de Visual Studio 2005; de lo contrario, FALSE.

Comentarios

Usa el style parámetro del CMFCTabCtrl::Create método para especificar cómo se dibujan las pestañas.

CMFCTabCtrl::m_bEnableActivate

Impide que la vista activa pierda el foco cuando se inserta y habilita una nueva pestaña.

static BOOL m_bEnableActivate;

Comentarios

Normalmente, el foco lo toma una nueva ventana con pestañas cuando se inserta y se activa la pestaña. Establece la CMFCTabCtrl::m_bEnableActivate variable miembro en FALSE para conservar el foco original. El valor predeterminado es TRUE.

CMFCTabCtrl::ModifyTabStyle

Especifica la apariencia de las pestañas en el control de pestañas actual.

BOOL ModifyTabStyle(Style style);

Parámetros

style
[in] Uno de los valores de enumeración que especifica la apariencia del control de pestaña. Para más información, consulta las tablas en Comentarios.

Valor devuelto

Siempre TRUE.

Comentarios

El valor del parámetro style puede ser una de los siguientes enumeraciones CMFCTabCtrl::Style.

Nombre Descripción
STYLE_3D Muestra pestañas rectangulares tridimensionales que tienen esquinas redondas.
STYLE_3D_ONENOTE Muestra pestañas tridimensionales que tienen un lado vertical y un lado inclinado y que tienen esquinas redondeadas.
STYLE_3D_ROUNDED Muestra pestañas tridimensionales que tienen lados inclinados y esquinas redondeadas.
STYLE_3D_ROUNDED_SCROLL Muestra pestañas tridimensionales que tienen lados inclinados y esquinas redondeadas. Si hay más pestañas de las que se pueden mostrar al mismo tiempo, el marco muestra una flecha desplegable y un menú de pestañas para activar.
STYLE_3D_SCROLLED Muestra pestañas tridimensionales y rectangulares. Si hay más pestañas de las que se pueden mostrar al mismo tiempo, el marco muestra una flecha desplegable y un menú de pestañas para activar.
STYLE_3D_VS2005 Muestra pestañas tridimensionales y redondeadas que tienen un lado inclinado y otro vertical.
STYLE_FLAT Muestra pestañas bidimensionales que tienen lados izquierdo y derecho inclinados.
STYLE_FLAT_SHARED_HORZ_SCROLL Muestra pestañas bidimensionales. Si hay más pestañas de las que se pueden mostrar al mismo tiempo, el marco muestra flechas de desplazamiento en los extremos del área de tabulación.

CMFCTabCtrl::OnDragEnter

Lo llama el marco durante una operación de arrastrar y colocar cuando el cursor entra por primera vez en la ventana del control de pestaña actual.

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parámetros

pDataObject
[in] Apunta a un objeto de datos que contiene los datos que arrastra el usuario.

dwKeyState
[in] Contiene el estado de las claves modificadoras. Este parámetro es una combinación bit a bit «o» (|) de los siguientes valores: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON y MK_RBUTTON. Para obtener más información, consulte la sección Parámetros del mensaje de Acerca de la entrada del mouse.

point
[in] Contiene la ubicación actual del cursor en coordenadas de cliente.

Valor devuelto

Siempre DROPEFFECT_NONE, lo que significa que el destino de colocación no puede aceptar los datos.

Comentarios

Usa este método para admitir una operación de arrastrar y colocar. Invalida este método para implementar su propio comportamiento personalizado.

De forma predeterminada, este método solo llama a CMFCTabCtrl::OnDragOver, que siempre devuelve DROPEFFECT_NONE.

CMFCTabCtrl::OnDragOver

Lo llama el marco durante una operación de arrastre cuando el mouse se mueve sobre la ventana de destino de colocación.

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parámetros

pDataObject
[in] Puntero a un COleDataObject objeto que se está arrastrando sobre el destino de colocación.

dwKeyState
[in] El estado de las claves modificadoras, que es una combinación bit a bit «o» (|) de MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON y MK_RBUTTON. Para obtener más información, consulta la sección «Parámetros del mensaje» en Acerca de la entrada del mouse.

point
[in] La posición actual del mouse.

Valor devuelto

Siempre DROPEFFECT_NONE.

Comentarios

Invalida este método para devolver tu implementación personalizada. Para obtener más información, vea el método CView::OnDragOver.

CMFCTabCtrl::OnShowTabDocumentsMenu

Muestra un menú emergente de ventanas con pestañas, espera hasta que el usuario selecciona una pestaña y hace que la pestaña seleccionada sea la pestaña activa.

virtual void OnShowTabDocumentsMenu(CPoint point);

Parámetros

point
[in] Las coordenadas de dónde mostrar el menú emergente.

Comentarios

CMFCTabCtrl::SetActiveInMDITabGroup

Establece la pestaña actual de un control de pestañas como la pestaña activa en un grupo de pestañas de la interfaz de múltiples documentos.

void SetActiveInMDITabGroup(BOOL bActive);

Parámetros

bActive
[in] TRUE para convertir la pestaña actual en la pestaña activa; FALSE para que la pestaña actual está inactiva.

Comentarios

Puede organizar varias ventanas de documento y ventanas de herramientas en grupos de pestañas horizontales o verticales e intercambiar documentos de un grupo a otro.

CMFCTabCtrl::SetActiveTab

Activa una pestaña.

virtual BOOL SetActiveTab(int iTab);

Parámetros

iTab
[in] Especifica el índice de base cero de la pestaña que se va a activar.

Valor devuelto

TRUE es si la pestaña especificada se ha realizado activa; FALSE si el valor del parámetro especificado iTab no es válido.

Comentarios

Esto envía la AFX_WM_CHANGE_ACTIVE_TAB notificación a la ventana primaria y al marco del control de pestaña del elemento primario.

El SetActiveTab método llama automáticamente al CMFCTabCtrl::HideActiveWindowHorzScrollBar método para evitar que la pantalla parpadee.

CMFCTabCtrl::SetActiveTabBoldFont

Habilita o deshabilita el uso de una fuente en negrita en pestañas activas.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Parámetros

bIsBold
[in] TRUE para usar una fuente en negrita para mostrar la etiqueta de la pestaña activa; FALSE para usar la fuente estándar para mostrar la etiqueta. El valor predeterminado es TRUE.

Comentarios

CMFCTabCtrl::SetDrawFrame

Especifica si un rectángulo de marco se dibuja alrededor de una barra incrustada.

void SetDrawFrame(BOOL bDraw=TRUE);

Parámetros

bDraw
[in] TRUE para mostrar un rectángulo de marco alrededor de una barra incrustada; de lo contrario, FALSE. El valor predeterminado es TRUE.

Comentarios

CMFCTabCtrl::SetFlatFrame

Especifica si se debe dibujar un marco plano o 3D alrededor del área de tabulación.

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

Parámetros

bFlat
[in] TRUE para dibujar un marco plano (2D) alrededor del área de tabulación; FALSE para dibujar un marco tridimensional (3D). El valor predeterminado es TRUE.

bRepaint
[in] TRUE para volver a dibujar la ventana inmediatamente; de lo contrario, FALSE. El valor predeterminado es TRUE.

Comentarios

CMFCTabCtrl::SetImageList

Especifica una lista de imagen.

virtual BOOL SetImageList(
    UINT uiID,
    int cx=15,
    COLORREF clrTransp=RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parámetros

uiID
[in] Identificador de un recurso de mapa de bits que contiene la lista de imágenes.

cx
[in] El ancho de cada imagen en píxeles. El valor predeterminado es 15.

clrTransp
[in] Color de imagen transparente. Las partes de la imagen que son este color serán transparentes. El valor predeterminado es el color magenta, RGB(255,0,255).

hImageList
[in] Un manipulador de una lista de imágenes precargadas.

Valor devuelto

TRUE si este método es correcto. FALSE si el control de tabulación se crea mediante un estilo plano o si la primera sobrecarga del método no puede cargar el mapa de bits especificado por el uiID parámetro .

Comentarios

Use este método para establecer una lista de imágenes para el control de pestaña. Las imágenes de la lista de imágenes se muestran junto a la etiqueta de pestaña. Este método recalcula el alto de tabulación para que la pestaña tenga el tamaño para contener la imagen y el texto.

Usa el CMFCBaseTabCtrl::AddTab método heredado por el control de pestaña para especificar el índice de la imagen que se va a mostrar.

CMFCTabCtrl::SetResizeMode

Especifica cómo se puede cambiar el tamaño del control de pestaña actual y, a continuación, vuelve a mostrar el control.

void SetResizeMode(ResizeMode resizeMode);

Parámetros

resizeMode
Uno de los CMFCTabCtrl::ResizeMode valores de enumeración que especifica cómo se puede cambiar el tamaño del control de tabulación. Para obtener una lista de los valores posibles, consulta la tabla en Comentarios.

Comentarios

El parámetro resizeMode puede ser uno de los siguientes valores de enumeración ResizeMode.

Nombre Descripción
RESIZE_NO No se puede cambiar el tamaño del control de tabulación.
RESIZE_VERT El control de pestaña se puede cambiar verticalmente, pero no horizontalmente.
RESIZE_HORIZ El control de pestaña se puede cambiar horizontalmente, pero no verticalmente.

CMFCTabCtrl::SetTabMaxWidth

Especifica el ancho máximo de tabulación en una ventana con pestañas.

void SetTabMaxWidth(int nTabMaxWidth);

Parámetros

nTabMaxWidth
[in] El ancho máximo de pestaña, en píxeles.

Comentarios

Use este método para limitar el ancho de cada pestaña en una ventana con pestañas. Este método es útil si las pestañas tienen etiquetas muy largas. El constructor de clase CMFCTabCtrl inicializa el ancho de tabulación máximo en 0, lo que significa que el ancho no está limitado.

CMFCTabCtrl::StopResize

Finaliza la operación de cambio de tamaño actual en el control de ficha.

void StopResize(BOOL bCancel);

Parámetros

bCancel
[in] TRUE para abandonar la operación de cambio de tamaño actual; FALSE para completar la operación de cambio de tamaño actual. En cualquier caso, el marco deja de dibujar el rectángulo de cambio de tamaño.

CMFCTabCtrl::SynchronizeScrollBar

Dibuja una barra de desplazamiento horizontal en un control de pestaña que muestra pestañas planas.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Parámetros

pScrollInfo
[out] Puntero a una estructura SCROLLINFO o NULL. Cuando este método devuelve y, si este parámetro no es NULL, la estructura contiene todos los parámetros de la barra de desplazamiento. El valor predeterminado es NULL.

Valor devuelto

TRUE si este método se realiza correctamente; de lo contrario, FALSE.

Comentarios

Este método solo afecta a un control de pestaña que muestra pestañas planas. La barra de desplazamiento influye en todas las pestañas al mismo tiempo.

Consulte también

Gráfico de jerarquías
Clases
CDockablePane (clase)
CMFCBaseTabCtrl (clase)