CMFCOutlookBar Class

Artículo
06/10/2015

Un panel con fichas con el aspecto visual Panel de exploración en Microsoft Outlook 2000 u Outlook 2003. El objeto de CMFCOutlookBar contiene un objeto de CMFCOutlookBarTabCtrl Class y una serie de fichas. Las fichas pueden ser objetos de CMFCOutlookBarPane Class o CWnd- objetos derivados. El usuario, la barra de Outlook aparece como una serie de botones y un área de presentación. Cuando el usuario hace clic en un botón, se muestra el panel de control correspondiente o del botón.

class CMFCOutlookBar : public CBaseTabbedPane

Members

Constructores públicos

Nombre	Descripción
CMFCOutlookBar::CMFCOutlookBar	Constructor predeterminado.
CMFCOutlookBar::~CMFCOutlookBar	Un destructor.

Métodos públicos

Nombre	Descripción
CMFCOutlookBar::AllowDestroyEmptyTabbedPane	Especifica si un panel con fichas vacío puede ser destruido. (Reemplaza CBaseTabbedPane::AllowDestroyEmptyTabbedPane.)
CMFCOutlookBar::CanAcceptPane	Determina si otro panel se puede acoplar el panel de barra de Outlook. (Reemplaza CDockablePane::CanAcceptPane.)
CMFCOutlookBar::CanSetCaptionTextToTabName	Determina si la leyenda del panel con fichas genera el mismo texto que la pestaña activa. (Reemplaza CBaseTabbedPane::CanSetCaptionTextToTabName.)
CMFCOutlookBar::Create	Crear el control de barra de Outlook.
CMFCOutlookBar::CreateCustomPage	Crea una pestaña personalizada de la barra de Outlook.
CMFCOutlookBar::CreateObject	Utiliza el marco para crear una instancia dinámica de este tipo de clase.
CMFCOutlookBar::DoesAllowDynInsertBefore	Determina si un usuario puede acoplar una barra de controles en el borde externo de la barra de Outlook.
CMFCOutlookBar::FloatTab	Flota un panel, pero solo si el panel se encuentra actualmente en una pestaña desmontable. (Reemplaza CBaseTabbedPane::FloatTab.)
CMFCOutlookBar::GetButtonsFont	Devuelve la fuente del texto de los botones de la barra de Outlook.
CMFCOutlookBar::GetTabArea	Devuelve el tamaño y la posición de las áreas de la pestaña respecto a la barra de Outlook. (Reemplaza CBaseTabbedPane::GetTabArea.)
CMFCOutlookBar::GetThisClass	Utiliza el marco para obtener un puntero al objeto de Recursos asociado a este tipo de clase.
CMFCOutlookBar::IsMode2003	Determina si el comportamiento de los imita de la barra de Outlook que de Microsoft Office Outlook 2003 (vea comentarios).
CMFCOutlookBar::OnAfterAnimation	Llamado por CMFCOutlookBarTabCtrl::SetActiveTab después de la pestaña activa se ha establecido mediante la animación.
CMFCOutlookBar::OnBeforeAnimation	Llamado por CMFCOutlookBarTabCtrl::SetActiveTab antes de una ficha se establece como la pestaña activa mediante la animación.
CMFCOutlookBar::OnScroll	Llamado por el marco si la barra de Outlook se desplaza hacia arriba o abajo.
CMFCOutlookBar::RemoveCustomPage	Quita una ficha personalizada de la barra de Outlook.
CMFCOutlookBar::SetButtonsFont	Establece la fuente del texto de los botones de la barra de Outlook.
CMFCOutlookBar::SetMode2003	Especifica si el comportamiento de los imita de la barra de Outlook que de Outlook 2003 (vea comentarios).

Comentarios

Para obtener un ejemplo de una barra de Outlook, vea Ejemplo de OutlookDemo: Aplicación MFC OutlookDemo.

Implementar la barra de Outlook

Para utilizar el control de CMFCOutlookBar en la aplicación, siga estos pasos:

Inserte un objeto de CMFCOutlookBar en la clase de ventana de marco principal.

class CMainFrame : public CMDIFrameWnd
 { ...
     CMFCOutlookBar         m_wndOutlookBar;
     CMFCOutlookBarPane     m_wndOutlookPane;
... };

Al procesar el mensaje de WM_CREATE en el marco principal, llame al método de CMFCOutlookBar::Create para crear el control de ficha de la barra de Outlook.
```
m_wndOutlookBar.Create (_T("Shortcuts"), this, CRect (0, 0, 100, 100), ID_VIEW_OUTLOOKBAR, WS_CHILD | WS_VISIBLE | CBRS_LEFT);
```

Obtener un puntero a CMFCOutlookBarTabCtrl subyacente mediante CBaseTabbedPane::GetUnderlyingWindow.

CMFCOutlookBarTabCtrl* pOutlookBar = (CMFCOutlookBarTabCtrl*) m_wndOutlookBar.GetUnderlyingWindow ();

Cree un objeto de CMFCOutlookBarPane Class para cada pestaña que contiene los botones.

m_wndOutlookPane.Create (&m_wndOutlookBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_OUTLOOK_PANE_GENERAL, AFX_CBRS_FLOAT | AFX_CBRS_RESIZE);
// make the Outlook pane detachable (enable docking)
m_wndOutlookPane.EnableDocking (CBRS_ALIGN_ANY);
// add buttons
m_wndOutlookPane.AddButton (theApp.LoadIcon (IDR_MAINFRAME), "About", ID_APP_ABOUT);
m_wndOutlookPane.AddButton (theApp.LoadIcon (IDR_CUSTOM_OPEN_ICON), "Open", ID_FILE_OPEN);

Llame a CMFCBaseTabCtrl::AddTab para agregar cada nueva pestaña. Establezca el parámetro de bDetachable a FALSE para que una página no desmontable. O, utilice CMFCOutlookBarTabCtrl::AddControl de agregar páginas desmontables.
```
pOutlookBar->AddTab (&m_wndOutlookPane, "General", (UINT) -1, TRUE); 
```
Para agregar CWnd- el control derivado (por ejemplo, CMFCShellTreeCtrl Class) como una ficha, crea el control y la llamada CMFCBaseTabCtrl::AddTab para agregarlo a la barra de Outlook.

Nota

Debe utilizar los id. únicos de control para cada objeto de CMFCOutlookBarPane Class y para cada CWnd- objeto derivado.

Para agregar o eliminar dinámicamente las nuevas páginas en tiempo de ejecución, el uso CMFCOutlookBar::CreateCustomPage y CMFCOutlookBar::RemoveCustomPage.

Modo de Outlook 2003

En el modo de Outlook 2003, los botones de la ficha se colocan en la parte inferior del panel de barra de Outlook. Cuando no hay suficiente espacio para mostrar botones, se muestran como iconos en una barra de herramientas- como área a lo largo de la parte inferior del panel.

Uso CMFCOutlookBar::SetMode2003 de habilitar el modo de Outlook 2003. Utilice CMFCOutlookBarTabCtrl::SetToolbarImageList para establecer el mapa de bits que contiene los iconos que se muestran en la parte inferior de la barra de Outlook. Los iconos del mapa de bits se deben ordenar por índice de tabulación.