CMFCTabCtrl Class

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

La CMFCTabCtrl clase proporciona funcionalidad para un control de ficha. 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.

class CMFCTabCtrl : public CMFCBaseTabCtrl  

Constructores públicos

NombreDescripción
CMFCTabCtrl::CMFCTabCtrlConstructor predeterminado.
CMFCTabCtrl::~CMFCTabCtrlDestructor.

Métodos públicos

NombreDescripción
CMFCTabCtrl::ActivateMDITabMuestra la ficha especificada del control de ficha actual y establece el foco en esa pestaña.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindowEspecifica 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 de los cambios de control de ficha.
CMFCTabCtrl::CalcRectEditDesinfla el tamaño del área de ficha especificado. (Invalida CMFCBaseTabCtrl::CalcRectEdit).
CMFCTabCtrl::CreateCrea el control de pestaña y lo adjunta a la CMFCTabCtrl objeto.
CMFCTabCtrl::CreateObjectUsado por el marco para crear una instancia dinámica de este tipo de clase.
CMFCTabCtrl::EnableActiveTabCloseButtonMuestra u oculta el botón Cerrar ( X) en la ficha activa.
CMFCTabCtrl::EnableInPlaceEditHabilita o deshabilita las etiquetas de la ficha editable. (Invalida CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenuReemplaza los dos botones que desplazar las fichas con un botón que abre un menú de ventanas con fichas.
CMFCTabCtrl::EnsureVisibleGarantiza que una ficha está visible.
CMFCTabCtrl::GetDocumentIconRecupera el símbolo que está asociado a una ficha en un menú emergente de ventanas con fichas.
CMFCTabCtrl::GetFirstVisibleTabNumRecupera el índice de la primera ficha que esté visible en el control de ficha actual.
CMFCTabCtrl::GetResizeModeRecupera un valor que especifica cómo se puede cambiar el tamaño de control de ficha actual.
CMFCTabCtrl::GetScrollBarRecupera un puntero al objeto de barra de desplazamiento que está asociado con el control de ficha.
CMFCTabCtrl::GetTabAreaRecupera el rectángulo delimitador del área de etiqueta de ficha en la parte superior o inferior del control de ficha. (Invalida CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPointRecupera la ficha que contiene un punto especificado. (Invalida CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidthRecupera el ancho máximo de una pestaña.
CMFCTabCtrl::GetTabsHeightRecupera el alto del área de ficha del control de ficha actual.
CMFCTabCtrl::GetTabsRectRecupera el rectángulo que delimita el área de fichas del control de ficha actual. (Invalida CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClassUsar el marco de trabajo para obtener un puntero a la CRuntimeClass objeto que está asociado a este tipo de clase.
CMFCTabCtrl::GetWndAreaRecupera los límites del área cliente del control de ficha actual.
CMFCTabCtrl::HideActiveWindowHorzScrollBarOculta la barra de desplazamiento horizontal, si existe, de la ventana activa.
CMFCTabCtrl::HideInactiveWindowEspecifica si el marco de trabajo es mostrar ventanas de control de ficha inactiva.
CMFCTabCtrl::HideNoTabsHabilita o deshabilita el área de fichas de dibujo si no hay ningún fichas visibles.
CMFCTabCtrl::HideSingleTabHabilita o deshabilita el dibujo de una ficha cuando hay una sola ventana con fichas. (Invalida CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroupIndica si la ficha actual de un control de ficha es la pestaña activa en un grupo de ficha de interfaz de documentos múltiples.
CMFCTabCtrl::IsActiveTabBoldFontIndica si el texto de la ficha activa se muestra con una fuente en negrita.
CMFCTabCtrl::IsActiveTabCloseButtonIndica si el botón Cerrar ( X) se muestra en una pestaña activa o en la esquina superior derecha del área de ficha.
CMFCTabCtrl::IsDrawFrameIndica si la ventana con fichas dibuja un rectángulo de marco alrededor de paneles incrustados.
CMFCTabCtrl::IsFlatFrameIndica si el marco que rodea el área de la pestaña es plana o en 3D.
CMFCTabCtrl::IsFlatTabIndica si la apariencia de las fichas del control de ficha actual es plana o no.
CMFCTabCtrl::IsLeftRightRoundedIndica si se redondea la apariencia de la izquierda y derecha de una ficha en el control de ficha actual.
CMFCTabCtrl::IsMDITabGroupIndica si el control de ficha actual se encuentra en el área de cliente de una ventana de interfaz de múltiples documentos.
CMFCTabCtrl::IsOneNoteStyleIndica si el control de ficha actual se muestra en el estilo de Microsoft OneNote.
CMFCTabCtrl::IsPtInTabAreaDetermina si un punto está dentro del área de ficha. (Invalida CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScrollIndica si el control de ficha actual tiene una barra de desplazamiento que se puede desplazar sus fichas como un grupo.
CMFCTabCtrl::IsTabDocumentsMenuIndica si el control de pestaña muestra los botones de desplazamiento o un botón que muestra un menú de ventanas con fichas.
CMFCTabCtrl::IsVS2005StyleIndica si las fichas se muestran en el estilo de Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyleEspecifica la apariencia de fichas del control de ficha actual.
CMFCTabCtrl::MoveTabMueve una pestaña a otra posición de tabulación. (Invalida CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnterLlamado por el marco cuando primero se arrastra el cursor en la ventana de control de ficha.
CMFCTabCtrl::OnDragOverLo llama el marco de trabajo durante una operación de arrastre cuando se mueve el mouse sobre la ventana de destino. (Invalida CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenuMuestra un menú emergente de ventanas con fichas, espera hasta que el usuario selecciona una ficha y hace que la ficha seleccionada sea la ficha activa.
CMFCTabCtrl::PreTranslateMessageConvierte los mensajes de ventana antes de que se envíen a la TranslateMessage y DispatchMessage funciones de Windows. (Invalida CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayoutVuelve a calcular el diseño interno del control de ficha. (Invalida CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroupLa ficha actual de un control de ficha se establece como la pestaña activa en un grupo de ficha de interfaz de documentos múltiples.
CMFCTabCtrl::SetActiveTabActiva una pestaña. (Invalida CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFontHabilita o deshabilita el uso de una fuente en negrita en fichas activas.
CMFCTabCtrl::SetDrawFrameHabilita o deshabilita el rectángulo de marco drawinga alrededor de una barra incrustada.
CMFCTabCtrl::SetFlatFrameEspecifica si se debe dibujar una plana o en un marco 3D alrededor del área de ficha.
CMFCTabCtrl::SetImageListEspecifica una lista de imágenes. (Invalida CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeModeEspecifica cómo se puede cambiar el tamaño de control de ficha actual y, a continuación, vuelve a mostrar el control.
CMFCTabCtrl::SetTabMaxWidthEspecifica el ancho máximo de ficha en una ventana con fichas.
CMFCTabCtrl::StopResizeFinaliza la operación de cambio de tamaño actual en el control de ficha.
CMFCTabCtrl::SwapTabsIntercambia un par de fichas. (Invalida CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBarDibuja una barra de desplazamiento horizontal de un control de ficha que muestra las fichas plana.

Miembros de datos

NombreDescripción
CMFCTabCtrl::m_bEnableActivateEvita que la vista activa pierde el foco cuando se inserta una nueva pestaña y se habilitado.

La CMFCTabCtrl clase es compatible con:

  • Pestaña estilos de control que incluyen 3D, sin formato y sin formato con una barra de desplazamiento horizontal compartida.

  • Situado en la parte superior o inferior de la ventana de fichas.

  • Fichas que muestran texto, imágenes o texto e imágenes.

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

  • Cambios de tamaño de borde para pestañas ajustables.

  • Ventanas con pestañas separables.

El CMFCTabCtrl clase puede usarse con un cuadro de diálogo, pero está diseñado para aplicaciones que utilizan acoplamiento controlar barras como Microsoft Excel y Visual Studio. Para obtener más información, consulte CDockablePane Class.

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

  1. Cree una instancia de CTabbedPane clase.

  2. Llame a CDockablePane::Create.

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

  4. Llame a CBasePane::EnableDocking para que el control de ficha de acoplamiento actual puede acoplar la ventana de marco principal.

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

Para obtener un ejemplo de cómo crear una ventana con fichas como una barra de control de acoplamiento, consulte CTabbedPane clase. Usar CMFCTabCtrl como un control de acoplamiento no crear un CMFCTabCtrl de objetos y, a continuación, llame a CMFCTabCtrl::Create.

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

En el ejemplo siguiente se muestra cómo usar varios métodos en la CMFCTabCtrl clase para configurar un CMFCTabCtrl objeto. En el ejemplo se explica cómo agregar una pestaña, mostrar el botón de cierre de la ficha activa, habilitar etiquetas editable y mostrar un menú emergente de etiquetas de la ventana con fichas. Este ejemplo forma parte de la muestra de recopilació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();

Encabezado: afxtabctrl.h

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

void ActivateMDITab(int nTab = -1);

Parámetros

[in] nTab
Índice de base cero de una ficha para mostrar, o -1 para especificar la ficha activa.

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.

virtual BOOL AllowDestroyEmptyTabbedPane() const;  

Valor devuelto

Siempre es TRUE.

Comentarios

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 de los cambios de control de ficha.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Parámetros

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

Comentarios

Crea el control de pestaña y lo adjunta a la CMFCTabCtrl objeto.

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

Parámetros

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

[in] rect
Un rectángulo que delimita el control de ficha.

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

[in] nID
El identificador del control de ficha.

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

[in] bCloseBtn
TRUEpara mostrar un botón Cerrar en la ficha; de lo contrario, FALSE. El valor predeterminado es FALSE.

Valor devuelto

TRUE si es correcto; de lo contrario, FALSE.

Comentarios

En la tabla siguiente se describe los valores que puede especificar para el style parámetro.

EstiloDescripción
STYLE_3DCrea un control de pestaña con una apariencia tridimensional.
STYLE_FLATCrea un control de pestaña con pestañas planas.
STYLE_FLAT_SHARED_HORZ_SCROLLCrea un control de pestaña con pestañas sin formato y una barra de desplazamiento que se puede desplazar las fichas si se recortan una ventana primaria.
STYLE_3D_ONENOTECrea un control de ficha en el estilo de Microsoft OneNote.
STYLE_3D_VS2005Crea un control de ficha en el estilo de Microsoft Visual Studio 2005.
STYLE_3D_ROUNDEDCrea un control de pestaña con pestañas redondeadas en el estilo de Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLLCrea un control de pestaña con redondeado fichas y botones de desplazamiento en el estilo de Microsoft Visual Studio 2005.

En la tabla siguiente se enumera los valores que puede especificar para el location parámetro.

UbicaciónDescripción
LOCATION_BOTTOMLas fichas se encuentran en la parte inferior del control de ficha.
LOCATION_TOPLas fichas se encuentran en la parte superior del control de ficha.

Ejemplo

En el ejemplo siguiente se muestra cómo utilizar el Create método en la CMFCTabCtrl clase. Este ejemplo forma parte de la muestra de recopilación de estado.

	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
	}

Desinfla el tamaño del área de ficha especificado.

virtual void CalcRectEdit(CRect& rectEdit);

Parámetros

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

Comentarios

Este método se llama cuando se cambia la etiqueta de una pestaña. Este método desinfla los lados izquierdo y derecho del rectángulo especificado por la mitad del alto actual de pestaña y desinfla arriba y abajo en una unidad.

Muestra u oculta el botón Cerrar ( X) en la ficha activa.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Parámetros

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

Habilita o deshabilita las etiquetas de la ficha editable.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parámetros

[in] bEnable
TRUEPara habilitar las etiquetas de la ficha editable; FALSE para deshabilitar las etiquetas de la ficha editable.

Comentarios

Alterna entre la interfaz de usuario que utiliza dos botones para desplazarse por las fichas de la ventana y una interfaz que muestra un menú emergente de ventanas con fichas.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Parámetros

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

Comentarios

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

Garantiza que una ficha está visible.

virtual BOOL EnsureVisible(int iTab);

Parámetros

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

Valor devuelto

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

Comentarios

Utilice este método para garantizar que la ficha especificada es visible. Si es necesario, se desplazará el control de ficha.

Recupera la imagen que está asociada a una ficha en un menú emergente de ventanas con fichas.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Parámetros

[in] nCmdID
El identificador de comando de una pestaña de un menú emergente de ventanas con fichas.

Valor devuelto

El identificador de una imagen de mapa de bits.

Recupera el índice de la primera ficha que esté visible en el control de ficha actual.

virtual int GetFirstVisibleTabNum() const;  

Valor devuelto

Índice de base cero de una ficha en el control de ficha.

Comentarios

Utilice este método sólo cuando el control de ficha se muestra en el estilo de Microsoft OneNote. Utilice la CMFCTabCtrl::IsOneNoteStyle método para determinar el estilo.

Recupera un valor que especifica cómo se puede cambiar el tamaño de 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 de control de ficha. Para obtener una lista de valores posibles, vea la sección Comentarios de la CMFCTabCtrl::SetResizeMode método.

Recupera un puntero al objeto de barra de desplazamiento que está asociado con el control de ficha.

CScrollBar* GetScrollBar();

Valor devuelto

Un puntero a un objeto de barra de desplazamiento o un NULL si el control de ficha no se creó utilizando el STYLE_FLAT_SHARED_HORZ_SCROLL estilo.

Comentarios

Utilice este método para tener acceso a la barra de desplazamiento incrustado del control de ficha. Se crea un objeto de barra de desplazamiento sólo cuando el control de ficha tiene la STYLE_FLAT_SHARED_HORZ_SCROLL estilo.

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

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

Parámetros

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

[out] rectTabAreaBottom
Cuando este método finaliza, esta referencia contiene un rectángulo que delimita 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 ficha en la parte inferior del control de ficha.

Comentarios

Utilice este método para determinar el tamaño y posición del área de ficha en la ventana con fichas.

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

Utilice la CMFCTabCtrl::SetTabMaxWidth para establecer el ancho máximo de ficha.

Recupera el alto del área de ficha del control de ficha actual.

virtual int GetTabsHeight() const;  

Valor devuelto

El alto del área de ficha si cualquier ficha está visible, o cero si no existe la ficha está visible.

Recupera el rectángulo que delimita el área de fichas del control de ficha actual.

virtual void GetTabsRect(CRect& rect) const;  

Parámetros

[out] rect
Cuando este método finaliza, el rect parámetro contiene un rectángulo que delimita el área de fichas.

Recupera los límites del área cliente del control de ficha actual.

void GetWndArea(CRect& rect) const;  

Parámetros

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

Comentarios

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

void HideActiveWindowHorzScrollBar();

Comentarios

Utilice este método para evitar que el control de ficha parpadea cuando el usuario cambia entre las páginas de control de ficha.

Especifica si el marco de trabajo muestra ventanas de control de ficha inactiva.

void HideInactiveWindow(BOOL bHide = TRUE);

Parámetros

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

Comentarios

Habilita o deshabilita el dibujo del área de ficha si no hay ningún fichas visibles.

void HideNoTabs(BOOL bHide=TRUE);

Parámetros

[in] bHide
TRUEPara habilitar el área de la ficha de dibujo FALSE para deshabilitar el dibujo. El valor predeterminado es TRUE.

Comentarios

Habilita o deshabilita el dibujo de ficha si hay una sola ventana con fichas.

virtual void HideSingleTab(BOOL bHide = TRUE);

Parámetros

[in] bHide
TRUEno dibujar una pestaña de una sola ventana con fichas; FALSE para dibujar una pestaña única. El valor predeterminado es TRUE.

Comentarios

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

BOOL IsActiveInMDITabGroup() const;  

Valor devuelto

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

Comentarios

Puede organizar varias ventanas de documento en ambos grupos de pestañas verticales u horizontales y mover fácilmente los documentos de grupo de una pestaña a otra.

Indica si el texto de la ficha activa se muestra con una fuente en negrita.

BOOL IsActiveTabBoldFont() const;  

Valor devuelto

TRUESi se muestra la ficha activa con la fuente en negrita; de lo contrario, FALSE.

Comentarios

Utilice la CMFCTabCtrl::SetActiveTabBoldFont método para cambiar la fuente de la ficha activa.

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

virtual BOOL IsActiveTabCloseButton() const;  

Valor devuelto

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

Comentarios

Indica si la ventana con fichas dibuja un rectángulo de marco alrededor de paneles incrustados.

BOOL IsDrawFrame() const;  

Valor devuelto

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

Comentarios

Utilice la CMFCTabCtrl::SetDrawFrame método para habilitar o deshabilitar dibujar un rectángulo de marco.

Indica si el marco que rodea el área de la pestaña es plana o en 3D.

BOOL IsFlatFrame() const;  

Valor devuelto

TRUESi el marco que rodea el área de la pestaña es plano; FALSE si el marco es tridimensional.

Comentarios

Utilice la CMFCTabCtrl::SetFlatFrame método para cambiar la forma en que el marco se dibuja.

Indica si la apariencia de las fichas del control de ficha actual es plana o no.

virtual BOOL IsFlatTab() const;  

Valor devuelto

TRUESi la apariencia de las fichas del control de ficha actual es plana; de lo contrario, FALSE.

Indica si se redondea la apariencia de la izquierda y derecha de una ficha en el control de ficha actual.

virtual BOOL IsLeftRightRounded() const;  

Valor devuelto

TRUESi se redondea los lados de cada ficha; de lo contrario, FALSE.

Indica si el control de ficha actual se encuentra en el área de cliente de una ventana de interfaz de múltiples documentos.

virtual BOOL IsMDITabGroup() const;  

Valor devuelto

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

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

virtual BOOL IsOneNoteStyle() const;  

Valor devuelto

TRUESi el control de ficha se muestra en el estilo de Microsoft OneNote; de lo contrario, FALSE.

Indica si el control de ficha actual tiene una barra de desplazamiento que se puede desplazar sus fichas como un grupo.

BOOL IsSharedScroll() const;  

Valor devuelto

TRUESi el control de ficha tiene una barra de desplazamiento compartido; de lo contrario, FALSE.

Comentarios

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

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

BOOL IsTabDocumentsMenu() const;  

Valor devuelto

TRUESi se desplazan ventanas con fichas mediante un menú emergente de etiquetas de la ventana con fichas; FALSE si se desplazan ventanas con fichas con botones de desplazamiento hacia delante y hacia atrás.

Comentarios

Utilice la CMFCTabCtrl::EnableTabDocumentsMenu ventanas de fichas de método para especificar el método de desplazamiento.

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

virtual BOOL IsVS2005Style() const;  

Valor devuelto

TRUESi las fichas se dibujan utilizando el estilo de Visual Studio 2005; de lo contrario, FALSE.

Comentarios

Utilice la style parámetro de la CMFCTabCtrl::Create método para especificar cómo se dibujan las fichas.

Evita que la vista activa pierde el foco cuando se inserta una nueva pestaña y se habilitado.

static BOOL m_bEnableActivate;  

Comentarios

El enfoque normalmente es realizado por una nueva ventana con fichas cuando se insertan y se activa la ficha. Establecer el CMFCTabCtrl::m_bEnableActivate la variable miembro que FALSE para conservar el enfoque original. El valor predeterminado es TRUE.

Especifica la apariencia de fichas del control de ficha actual.

BOOL ModifyTabStyle(Style style);

Parámetros

[in] style
Uno de los valores de enumeración que especifica la apariencia del control de ficha. Para obtener más información, vea la tabla en la sección Comentarios.

Valor devuelto

Siempre es TRUE.

Comentarios

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

NombreDescripción
STYLE_3DMuestra las fichas tridimensionales, rectangulares con esquinas redondeadas.
STYLE_3D_ONENOTEMuestra las fichas tridimensionales que tienen uno de los lados vertical y un lado inclinado y esquinas redondeadas.
STYLE_3D_ROUNDEDMuestra tridimensionales pestañas inclinado lados y esquinas redondeadas.
STYLE_3D_ROUNDED_SCROLLMuestra tridimensionales pestañas inclinado lados y esquinas redondeadas. Si hay más fichas que se pueden mostrar al mismo tiempo, el marco de trabajo muestra una flecha de lista desplegable y un menú de las fichas de activos.
STYLE_3D_SCROLLEDMuestra las fichas tridimensionales, rectangulares. Si hay más fichas que se pueden mostrar al mismo tiempo, el marco de trabajo muestra una flecha de lista desplegable y un menú de las fichas de activos.
STYLE_3D_VS2005Muestra tridimensional, redondear las fichas que disponen de un lado inclinado y un lado vertical.
STYLE_FLATMuestra las fichas bidimensionales que han inclinado lados izquierdo y derecho.
STYLE_FLAT_SHARED_HORZ_SCROLLMuestra las fichas bidimensionales. Si hay más fichas que se pueden mostrar al mismo tiempo, el marco de trabajo muestra flechas de desplazamiento al final del área de ficha.

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

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

Parámetros

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

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

[in] point
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 acepta los datos.

Comentarios

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

De forma predeterminada, este método se llama sólo CMFCTabCtrl::OnDragOver, que siempre devuelve DROPEFFECT_NONE.

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

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

Parámetros

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

[in] dwKeyState
El estado de las teclas 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, vea "Parámetros de mensaje" en acerca de la entrada del Mouse.

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

Valor devuelto

Siempre es DROPEFFECT_NONE.

Comentarios

Invalide este método con su implementación personalizada. Para obtener más información, consulte el CView::OnDragOver método.

Muestra un menú emergente de ventanas con fichas, espera hasta que el usuario selecciona una ficha y hace que la ficha seleccionada sea la ficha activa.

virtual void OnShowTabDocumentsMenu(CPoint point);

Parámetros

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

Comentarios

La ficha actual de un control de ficha se establece como la pestaña activa en un grupo de pestañas de interfaz de múltiples documentos.

void SetActiveInMDITabGroup(BOOL bActive);

Parámetros

[in] bActive
TRUEpara realizar la ficha actual de la ficha activa; FALSE para desactivar la ficha actual.

Comentarios

Puede organizar varias ventanas de documento en ambos grupos de pestañas verticales u horizontales y mover fácilmente los documentos de grupo de una pestaña a otra.

Activa una pestaña.

virtual BOOL SetActiveTab(int iTab);

Parámetros

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

Valor devuelto

TRUESi la ficha especificada se realizó activa; FALSE si especificado iTab valor de parámetro no es válido.

Comentarios

Este método no envía el AFX_WM_CHANGE_ACTIVE_TAB notificación a la ventana primaria del control de ficha.

El SetActiveTab método se llama de forma automática el CMFCTabCtrl::HideActiveWindowHorzScrollBar método para impedir que la pantalla parpadee.

Habilita o deshabilita el uso de una fuente en negrita en fichas activas.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Parámetros

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

Comentarios

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

void SetDrawFrame(BOOL bDraw=TRUE);

Parámetros

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

Comentarios

Especifica si se debe dibujar una plana o en un marco 3D alrededor del área de ficha.

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

Parámetros

[in] bFlat
TRUEpara dibujar un marco plana (2D) alrededor del área de ficha; FALSE para dibujar un marco tridimensional (3D). El valor predeterminado es TRUE.

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

Comentarios

Especifica una lista de imágenes.

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

Parámetros

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

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

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

[in] hImageList
Identificador de una lista de imágenes cargadas previamente.

Valor devuelto

TRUESi este método se realiza correctamente. FALSESi el control de ficha se crea mediante un estilo plano o si la primera sobrecarga de método no puede cargar el mapa de bits especificado por el uiID parámetro.

Comentarios

Utilice este método para establecer una lista de imágenes para el control de ficha. Las imágenes de la lista de imágenes se muestran al lado de la etiqueta de ficha. Este método vuelve a calcular el alto de la pestaña para que el tamaño de la ficha se ajusta para que contenga la imagen y el texto.

Utilice la CMFCBaseTabCtrl::AddTab método heredado por el control de ficha para especificar el índice de la imagen para mostrar.

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

void SetResizeMode(ResizeMode resizeMode);

Parámetros

[in] resizeMode
Uno de los CMFCTabCtrl::ResizeMode valores de enumeración que especifica cómo se puede cambiar el tamaño de control de ficha. Para obtener una lista de valores posibles, vea la tabla en la sección Comentarios.

Comentarios

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

NombreDescripción
RESIZE_NONo puede cambiarse el control de ficha.
RESIZE_VERTEl control de ficha se puede cambiar de tamaño verticalmente pero no horizontalmente.
RESIZE_HORIZEl control de ficha se puede cambiar de tamaño horizontalmente pero no verticalmente.

Especifica el ancho máximo de ficha en una ventana con fichas.

void SetTabMaxWidth(int nTabMaxWidth);

Parámetros

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

Comentarios

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

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

void StopResize(BOOL bCancel);

Parámetros

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

Dibuja una barra de desplazamiento horizontal de un control de ficha que muestra las fichas plana.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Parámetros

[out] pScrollInfo
Puntero a un SCROLLINFO estructura 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

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

Comentarios

Este método afecta a un control de ficha que muestra las fichas plana. La barra de desplazamiento afecta a todas las fichas al mismo tiempo.

Gráfico de jerarquía
Clases
Clase CDockablePane
Clase CDockablePane
Clase CMFCBaseTabCtrl

Mostrar: