Compartir a través de

CMFCOutlookBarTabCtrl (clase)

  • Artículo

Un control de pestaña que tiene el aspecto visual del Panel de navegación de Microsoft Outlook. Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

Sintaxis

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Miembros

Constructores públicos

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

Métodos públicos

Nombre Descripción
CMFCOutlookBarTabCtrl::AddControl Agrega un control de Windows como una nueva pestaña en la barra de Outlook.
CMFCOutlookBarTabCtrl::CalcRectEdit Llamado por el marco para determinar las dimensiones del cuadro de edición que aparece cuando un usuario cambia el nombre de una pestaña. (Invalida CMFCBaseTabCtrl::CalcRectEdit).
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons Llamado por el marco durante las operaciones de cambio de tamaño para determinar si se pueden mostrar menos botones de ficha de la barra de Outlook de los que están visibles actualmente.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons Llamado por el marco durante las operaciones de cambio de tamaño para determinar si se pueden mostrar más botones de ficha de la barra de Outlook de los que están visibles actualmente.
CMFCOutlookBarTabCtrl::Create Crea el control de pestaña de la barra de Outlook.
CMFCOutlookBarTabCtrl::CreateObject Usado por el marco de trabajo para crear una instancia dinámica de este tipo de clase.
CMFCOutlookBarTabCtrl::EnableAnimation Especifica si está habilitada la animación que se produce durante el cambio entre pestañas activas.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit Especifica si un usuario puede modificar las etiquetas de texto en los botones de pestaña de la barra de Outlook. (Invalida CMFCBaseTabCtrl::EnableInPlaceEdit).
CMFCOutlookBarTabCtrl::EnableScrollButtons Llamado por el marco para habilitar botones que permiten al usuario desplazarse por los botones en el panel de barras de Outlook.
CMFCOutlookBarTabCtrl::FindTargetWnd Identificará el panel que contenga un punto especificado. (Invalida CMFCBaseTabCtrl::FindTargetWnd).
CMFCOutlookBarTabCtrl::GetBorderSize Devuelve el tamaño del borde del control de pestañas de Outlook.
CMFCOutlookBarTabCtrl::GetTabArea Recupera el tamaño y la posición del área de la pestaña del control de pestañas. (Invalida CMFCBaseTabCtrl::GetTabArea).
CMFCOutlookBarTabCtrl::GetThisClass Lo usa el marco para obtener un puntero al objeto CRuntimeClass asociado a este tipo de clase.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation Determina si está habilitada la animación que se produce durante el cambio entre pestañas activas.
CMFCOutlookBarTabCtrl::IsMode2003 Determina si el control de pestaña de la barra de Outlook está en un modo que emula Microsoft Outlook 2003.
CMFCOutlookBarTabCtrl::IsPtInTabArea Determina si un punto está dentro del área de pestaña. (Invalida CMFCBaseTabCtrl::IsPtInTabArea).
CMFCOutlookBarTabCtrl::IsTabDetachable Determina si es posible desasociar una pestaña. (Invalida CMFCBaseTabCtrl::IsTabDetachable).
CMFCOutlookBarTabCtrl::OnChangeTabs Llamado por el marco cuando se inserta o se quita una pestaña. (Invalida CMFCBaseTabCtrl::OnChangeTabs).
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons Llamado por el marco para reducir el número de botones de ficha que están visibles.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons Llamado por el marco para aumentar el número de botones de ficha que están visibles.
CMFCOutlookBarTabCtrl::OnShowOptions Muestra el diálogo Opciones del panel de navegación.
CMFCOutlookBarTabCtrl::RecalcLayout Vuelve a calcular el diseño interno del control de pestañas. (Invalida CMFCBaseTabCtrl::RecalcLayout).
CMFCOutlookBarTabCtrl::SetActiveTab Establece la pestaña activa. (Invalida CMFCBaseTabCtrl::SetActiveTab).
CMFCOutlookBarTabCtrl::SetBorderSize Establece el tamaño del borde del control de pestañas de Outlook.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign Establece la alineación de las etiquetas de texto en los botones de pestaña de la barra de Outlook.
CMFCOutlookBarTabCtrl::SetToolbarImageList Establece el mapa de bits que contiene los iconos que se muestran en la parte inferior de la barra de Outlook en modo Outlook 2003 (vea CMFCOutlookBar Class).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Comentarios

Para crear una barra de Outlook que tenga compatibilidad con acoplamiento, use un objeto CMFCOutlookBar para hospedar el control de pestaña de la barra de Outlook. (Para obtener más información, consulte CMFCOutlookBar (clase)).

Ejemplo

En el siguiente ejemplo se muestra cómo inicializar un objeto CMFCOutlookBarTabCtrl y cómo usar varios métodos de la clase CMFCOutlookBarTabCtrl. En el ejemplo se muestra cómo habilitar la edición local de la etiqueta de texto en los botones de la ficha de la barra de Outlook, habilitar la animación, habilitar los manipuladores de desplazamiento que permiten al usuario desplazarse por botones en el panel de la barra de Outlook, establecer el tamaño del borde del control de pestaña de Outlook y establecer la alineación de las etiquetas de texto en los botones de pestaña de la barra de Outlook. Este fragmento de código forma parte del ejemplo de demostración de Outlook.

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();

pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCOutlookBarTabCtrl

Requisitos

Encabezado: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Agrega un control de Windows como una nueva pestaña en la barra de Outlook.

void AddControl(
    CWnd* pWndCtrl,
    LPCTSTR lpszName,
    int nImageID=-1,
    BOOL bDetachable=TRUE,
    DWORD dwControlBarStyle=AFX_CBRS_FLOAT |  AFX_CBRS_CLOSE | AFX_CBRS_RESIZE |  CBRS_AFX_AUTOHIDE);

Parámetros

pWndCtrl
[in] Puntero a un control que se va a agregar.

lpszName
[in] Especifica el nombre de la pestaña.

bDetachable
[in] Si es TRUE, la página se creará como desasociable.

nImageID
[in] Índice de imagen en la lista de imágenes interna de la imagen que se mostrará en la nueva pestaña.

dwControlBarStyle
[in] Especifica el estilo AFX_ CBRS_* para los paneles de acoplamiento ajustados.

Comentarios

Use esta función para agregar un control como una página nueva de una barra de Outlook.

Esta función llama internamente a CMFCBaseTabCtrl::AddTab.

Si establece bDetachable en TRUE, AddControl crea internamente un objeto CDockablePaneAdapter y ajusta el control agregado. Establece automáticamente la clase en tiempo de ejecución de la ventana con pestañas en la clase en tiempo de ejecución de CMFCOutlookBar y la clase en tiempo de ejecución del marco flotante en CMultiPaneFrameWnd.

Ejemplo

El siguiente ejemplo muestra cómo se usa el método AddControl de la clase CMFCOutlookBarTabCtrl. Este fragmento de código forma parte del ejemplo de demostración de Outlook.

// CMFCOutlookBarTabCtrl* pOutlookBar
// DWORD dwStyle = AFX_CBRS_FLOAT | AFX_CBRS_AUTOHIDE | AFX_CBRS_RESIZE
// CMFCOutlookBarPane pane1
// The third parameter is the image index.
pOutlookBar->AddControl(&pane1, _T("General"), 0, TRUE, dwStyle);

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

Llamado por el marco durante las operaciones de cambio de tamaño para determinar si se pueden mostrar menos botones de ficha de la barra de Outlook de los que están visibles actualmente.

virtual BOOL CanShowFewerPageButtons() const;

Valor devuelto

TRUE si hay más de un botón; en caso contrario, FALSE.

Comentarios

El control de pestaña de la barra de Outlook agrega o quita de forma dinámica las pestañas de la pantalla en función de la cantidad de espacio disponible. El marco usa este método para ayudar en ese proceso.

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Llamado por el marco durante las operaciones de cambio de tamaño para determinar si se pueden mostrar más botones de ficha de la barra de Outlook de los que están visibles actualmente.

virtual BOOL CanShowMorePageButtons() const;

Valor devuelto

TRUE si hay botones que no están visibles actualmente; en caso contrario, FALSE.

Comentarios

El control de pestaña de la barra de Outlook agrega o quita de forma dinámica las pestañas de la pantalla en función de la cantidad de espacio disponible. El marco usa este método para ayudar en ese proceso.

CMFCOutlookBarTabCtrl::Create

Crea el control de pestaña de la barra de Outlook.

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

Parámetros

rect
[in] Especifica el tamaño inicial y la posición en píxeles.

pParentWnd
[in] Punteros a la ventana primaria. No debe ser NULL.

Nid
[in] La id. del control.

Valor devuelto

Distinto de cero si el control se ha creado correctamente; de lo contrario, 0.

Comentarios

Normalmente, los controles de pestaña de la barra de Outlook se crean cuando CMFCOutlookBar Class controla el mensaje WM_CREATE del proceso.

CMFCOutlookBarTabCtrl::EnableAnimation

Especifica si está habilitada la animación que se produce durante el cambio entre pestañas activas.

static void EnableAnimation(BOOL bEnable=TRUE);

Parámetros

bEnable
[in] Especifica si la animación se debe habilitar o deshabilitar.

Comentarios

Llame a esta función para habilitar y deshabilitar la animación. Cuando el usuario abre una página de pestaña, el título de la página se desliza hacia arriba o hacia abajo si la animación está habilitada. Si la animación está deshabilitada, la página se activa inmediatamente.

De forma predeterminada, la animación está habilitada.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Especifica si un usuario puede modificar las etiquetas de texto en los botones de ficha de la barra de Outlook.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parámetros

bEnable
Si es TRUE, habilite la edición local de la etiqueta de texto. Si es FALSE, deshabilite la edición local.

Comentarios

Llame a esta función para habilitar o deshabilitar la edición local de etiquetas de texto en los botones de las fichas. De forma predeterminada, la edición local está deshabilitada.

CMFCOutlookBarTabCtrl::EnableScrollButtons

Llamado por el marco para habilitar manipuladores de desplazamiento que permiten al usuario desplazarse por los botones en el panel de barras de Outlook.

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

Parámetros

bEnable
[in] Determina si se muestran los botones de desplazamiento.

bIsUp
[in] Determina si se muestra la barra de desplazamiento superior.

bIsDown
[in] Determina si se muestra la barra de desplazamiento inferior.

Comentarios

Habilita la visualización de los botones de desplazamiento. El marco llama a este método cuando cambia la pestaña activa para restaurar los botones de desplazamiento.

CMFCOutlookBarTabCtrl::GetBorderSize

Devuelve el tamaño del borde del control de pestañas de Outlook.

int GetBorderSize() const;

Valor devuelto

Tamaño del borde en píxeles.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

Valor devuelto

Comentarios

CMFCOutlookBarTabCtrl::IsAnimation

Especifica si está habilitada la animación que se produce durante el cambio entre pestañas activas.

static BOOL IsAnimation();

Valor devuelto

Distinto de cero si la animación está habilitada; de lo contrario, 0.

Comentarios

Llame a la función CMFCOutlookBarTabCtrl::EnableAnimation para habilitar o deshabilitar la animación.

CMFCOutlookBarTabCtrl::IsMode2003

Determina si el control de pestaña de la barra de Outlook está en un modo que emula Microsoft Outlook 2003.

BOOL IsMode2003() const;

Valor devuelto

TRUE si el control de pestaña de la barra de Outlook está en modo Outlook 2003; en caso contrario, FALSE;

Comentarios

Este valor está definido por CMFCOutlookBar::SetMode2003.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Llamado por el marco para reducir el número de botones de ficha que están visibles.

virtual void OnShowFewerPageButtons();

Comentarios

Este método ajusta el número de botones de pestaña visibles de la página cuando se cambia el tamaño del control.

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Llamado por el marco para aumentar el número de botones de ficha que están visibles.

virtual void OnShowMorePageButtons();

Comentarios

Este método ajusta el número de botones de ficha que están visibles cuando se cambia el tamaño del control.

CMFCOutlookBarTabCtrl::OnShowOptions

Muestra el cuadro de diálogo Opciones del panel de navegación.

virtual void OnShowOptions();

Comentarios

El cuadro de diálogo Opciones del panel de navegación permite al usuario seleccionar qué botones de la ficha se van a mostrar y el orden en que se muestran.

El marco llama a este método cuando el usuario selecciona el elemento de menú Opciones del panel de navegación en el menú de personalización del control.

CMFCOutlookBarTabCtrl::SetActiveTab

Establece la pestaña activa. La pestaña activa es la que está abierta, con su contenido visible.

virtual BOOL SetActiveTab(int iTab);

Parámetros

iTab
[in] El índice de base cero de una pestaña que se va a abrir.

Valor devuelto

Distinto de cero si la pestaña especificada se ha abierto correctamente; de lo contrario, 0.

Comentarios

El efecto visual de establecer la pestaña activa depende de si ha habilitado la animación. Para más información, vea CMFCOutlookBarTabCtrl::EnableAnimation.

CMFCOutlookBarTabCtrl::SetBorderSize

Establece el tamaño del borde del control de pestañas de Outlook.

void SetBorderSize(int nBorderSize);

Parámetros

nBorderSize
[in] Especifica el nuevo tamaño de borde en píxeles.

Comentarios

Establece el nuevo tamaño de borde y vuelve a calcular el diseño de la ventana de Outlook.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Establece la alineación de las etiquetas de texto en los botones de pestaña de la barra de Outlook.

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

Parámetros

uiAlign
[in] Especifica la alineación del texto.

bRedraw
[in] Si es TRUE, se volverá a dibujar la ventana de Outlook.

Comentarios

Use esta función para cambiar la alineación del texto de los botones de página.

uiAlign puede tener uno de los siguientes valores:

Constante Significado
TA_LEFT Alineación a la izquierda
TA_CENTER Alineación central
TA_RIGHT Alineación a la derecha

El valor predeterminado es TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

Establece el mapa de bits que contiene los iconos que se muestran en la parte inferior de la barra de Outlook en modo Outlook 2003.

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

Parámetros

uiID
[in] Especifica el identificador de recurso de la imagen que se va a cargar.

cx
[in] Especifica el ancho de una imagen en la lista de imágenes, en píxeles.

clrTransp
[in] Valor RGB que especifica el color transparente.

Valor devuelto

Devuelve TRUE si se realiza correctamente; en caso contrario, devuelve FALSE.

Comentarios

Use esta función para adjuntar una lista de imágenes cuyas imágenes se mostrarán en los botones de la barra de herramientas en el modo de Microsoft Office 2003. Los índices de imagen deben corresponder a los índices de página.

No se debe llamar a este método si no está en modo Microsoft Office 2003. (Para obtener más información, consulte CMFCOutlookBar (clase)).

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

Parámetros

[in] nVisiblePageButtons

Comentarios

Consulte también

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