Classe CMFCOutlookBar

Artigo
06/10/2015

Um painel com guias com a aparência visual de Painel de Navegação no Microsoft Outlook 2000 ou no Outlook 2003. O objeto de CMFCOutlookBar contém um objeto de Classe CMFCOutlookBarTabCtrl e uma série de guias. As guias podem ser objetos de Classe CMFCOutlookBarPane ou CWndde objetos derivados. Para o usuário, a barra do Outlook aparece como uma série de botões e uma área de exibição. Quando o usuário clica em um botão, o painel de controle correspondente ou do botão é exibido.

class CMFCOutlookBar : public CBaseTabbedPane

Membros

Construtores Públicos

Nome	Descrição
CMFCOutlookBar::CMFCOutlookBar	Construtor padrão.
CMFCOutlookBar::~CMFCOutlookBar	Destruidor.

Métodos Públicos

Nome	Descrição
CMFCOutlookBar::AllowDestroyEmptyTabbedPane	Especifica se um painel com guias vazio pode ser destruído. Overrides ( CBaseTabbedPane::AllowDestroyEmptyTabbedPane.)
CMFCOutlookBar::CanAcceptPane	Determina se outro painel puder ser encaixado no painel da barra do Outlook. Overrides (CDockablePane::CanAcceptPane.)
CMFCOutlookBar::CanSetCaptionTextToTabName	Determina se a legenda para o painel com guias exibe o mesmo texto que a ativo. Overrides ( CBaseTabbedPane::CanSetCaptionTextToTabName.)
CMFCOutlookBar::Create	Cria o controle de barra do Outlook.
CMFCOutlookBar::CreateCustomPage	Cria um guia da barra do Outlook personalizado.
CMFCOutlookBar::CreateObject	Usado pela estrutura dinâmica para criar uma instância desse tipo da classe.
CMFCOutlookBar::DoesAllowDynInsertBefore	Determina se um usuário pode inserir uma barra de controle na borda externa da barra do Outlook.
CMFCOutlookBar::FloatTab	Flutua um painel, mas somente se o painel está atualmente em uma guia destacável. Overrides ( CBaseTabbedPane::FloatTab.)
CMFCOutlookBar::GetButtonsFont	Retorna a fonte do texto nos botões da barra do Outlook.
CMFCOutlookBar::GetTabArea	Retorna o tamanho e a posição das áreas da guia na barra do Outlook. Overrides ( CBaseTabbedPane::GetTabArea.)
CMFCOutlookBar::GetThisClass	Usado pela estrutura para obter um ponteiro para o objeto de CRuntimeClass que está associado com esse tipo da classe.
CMFCOutlookBar::IsMode2003	Determina se o comportamento de mostrado na barra do Outlook do Microsoft Office Outlook 2003 (consulte comentários.)
CMFCOutlookBar::OnAfterAnimation	Chamado por CMFCOutlookBarTabCtrl::SetActiveTab após a guia ativa foi definido usando a animação.
CMFCOutlookBar::OnBeforeAnimation	Chamado por CMFCOutlookBarTabCtrl::SetActiveTab antes de uma guia é definida como a guia ativa que usa a animação.
CMFCOutlookBar::OnScroll	Chamado pela estrutura se a barra do Outlook estiver enrolando para cima ou para baixo.
CMFCOutlookBar::RemoveCustomPage	Remove um guia da barra do Outlook personalizado.
CMFCOutlookBar::SetButtonsFont	Define a fonte do texto nos botões da barra do Outlook.
CMFCOutlookBar::SetMode2003	Especifica se o comportamento de mostrado na barra do Outlook do Outlook 2003 (consulte comentários.)

Comentários

Para um exemplo de uma barra do Outlook, consulte Exemplo de OutlookDemo: Aplicativo MFC OutlookDemo.

Implementando a barra do Outlook

Para usar CMFCOutlookBar controle em seu aplicativo, siga estas etapas:

Inserir um objeto de CMFCOutlookBar na classe de janela do quadro chave.

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

Ao processar a mensagem de WM_CREATE no quadro chave, chame o método de CMFCOutlookBar::Create para criar o controle da guia da barra do Outlook.
```
m_wndOutlookBar.Create (_T("Shortcuts"), this, CRect (0, 0, 100, 100), ID_VIEW_OUTLOOKBAR, WS_CHILD | WS_VISIBLE | CBRS_LEFT);
```

Obtenha um ponteiro para CMFCOutlookBarTabCtrl subjacente usando CBaseTabbedPane::GetUnderlyingWindow.

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

Crie um objeto de Classe CMFCOutlookBarPane para cada guia que contém botões.

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

Chame CMFCBaseTabCtrl::AddTab para adicionar cada nova guia. Defina o parâmetro de bDetachable a FALSE para fazer uma página não destacável. Ou, use CMFCOutlookBarTabCtrl::AddControl adicionar páginas destacáveis.
```
pOutlookBar->AddTab (&m_wndOutlookPane, "General", (UINT) -1, TRUE); 
```
Para adicionar CWnd- o controle derivado (por exemplo, Classe CMFCShellTreeCtrl) como um guia, cria o controle e a chamada CMFCBaseTabCtrl::AddTab para adicioná-lo à barra do Outlook.

Dica

Você deve usar identificações exclusivas de controle para cada objeto de Classe CMFCOutlookBarPane e para cada CWndobjeto derivado de.

Para adicionar ou excluir dinamicamente novas páginas em tempo de execução, em uso CMFCOutlookBar::CreateCustomPage e em CMFCOutlookBar::RemoveCustomPage.

Modo do Outlook 2003

No modo do Outlook 2003, os botões são posicionados na guia na parte inferior do painel da barra do Outlook. Quando não há espaço suficiente uma exibir botões, são exibidos como ícones na barra de ferramentas- como a área na parte inferior do painel.

Use CMFCOutlookBar::SetMode2003 para ativar o modo do Outlook 2003. Use CMFCOutlookBarTabCtrl::SetToolbarImageList para definir o bitmap que contém os ícones que são exibidos na parte inferior da barra do Outlook. Ícones no bitmap devem ser ordenados pelo índice de tabulação.