Classe CMFCOutlookBar

Artigo
08/25/2010

Isso Zoom, Para Cima e Ampliar está em construção.

Um painel com guias com a aparência visual do Painel de navegação no Microsoft Outlook 2000 ou no Outlook 2003.The CMFCOutlookBar objeto contém uma Classe CMFCOutlookBarTabCtrl objeto e uma série de guias. As guias podem ser qualquer um dos Classe CMFCOutlookBarPane objetos ou CWnd-objetos derivados. Para o usuário, a BAR do Outlook aparece sistema autônomo uma série de botões e uma área de exibição.Quando o usuário clica em um botão, o controle correspondente ou painel 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	(Substitui CBaseTabbedPane::AllowDestroyEmptyTabbedPane.)
CMFCOutlookBar::CanAcceptPane	Determina se outro painel pode ser encaixado para o painel de BAR do Outlook.(Substitui CDockablePane::CanAcceptPane).
CMFCOutlookBar::CanSetCaptionTextToTabName	Determina se a legenda para o painel com guias exibirá o mesmo texto sistema autônomo a guia ativo.(Substitui CBaseTabbedPane::CanSetCaptionTextToTabName.)
CMFCOutlookBar::criar	Cria o controle de BAR do Outlook.
CMFCOutlookBar::CreateCustomPage	Cria uma guia personalizada de BAR do Outlook.
CMFCOutlookBar::CreateObject	Usados pela estrutura para criar uma instância desse tipo de classe dinâmica.
CMFCOutlookBar::DoesAllowDynInsertBefore	Determina se um usuário pode encaixar uma BAR de controle na borda externa da BAR do Outlook.
CMFCOutlookBar::FloatTab	Flutua um painel, mas somente se o painel atualmente residir em uma guia removível.(Substitui CBaseTabbedPane::FloatTab.)
CMFCOutlookBar::GetButtonsFont	Retorna a fonte do texto nos botões da BAR do Outlook.
CMFCOutlookBar::GetDockingStatus	Chamado pela estrutura para gerenciar o comportamento de ancoragem.(Substitui CDockablePane::GetDockingStatus.)
CMFCOutlookBar::GetPaneName	Obtém o texto da janela para o painel. (Substitui CPane::GetPaneName.)
CMFCOutlookBar::GetTabArea	Retorna o dimensionar e posição das áreas de guia na BAR do Outlook.(Substitui CBaseTabbedPane::GetTabArea.)
CMFCOutlookBar::GetThisClass	Usado pela estrutura para obter um ponteiro para o CRuntimeClass objeto que está associado a este tipo de classe.
CMFCOutlookBar::IsMode2003	Determina se o comportamento da BAR do Outlook irá simular do Microsoft Office Outlook 2003 (consulte os comentários).
CMFCOutlookBar::LoadState	Chamado pela estrutura para carregar o estado do registro.(Substitui CBaseTabbedPane::LoadState.)
CMFCOutlookBar::OnAfterAnimation
CMFCOutlookBar::OnBeforeAnimation
CMFCOutlookBar::OnScroll
CMFCOutlookBar::RemoveCustomPage	Remove uma guia personalizada de BAR do Outlook.
CMFCOutlookBar::SaveState	Chamado pela estrutura de salvar o estado do painel de registro. (Substitui CBaseTabbedPane::SaveState.)
CMFCOutlookBar::SetButtonsFont	Define a fonte do texto nos botões da BAR do Outlook.
CMFCOutlookBar::SetMode2003	Especifica se o comportamento da BAR do Outlook imita do Outlook 2003 (consulte os comentários).

Comentários

Para obter um exemplo de uma BAR do Outlook, consulte o Exemplo do OutlookDemo: Aplicativo do MFC OutlookDemo.

Implementando a BAR do Outlook

Para usar o CMFCOutlookBar controle em seu aplicativo, execute essas etapas:

Incorporar um CMFCOutlookBar objeto para a classe de janela de quadro principal.

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

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

Obter um ponteiro para o base CMFCOutlookBarTabCtrl usando o CBaseTabbedPane::GetUnderlyingWindow.

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

Criar um Classe CMFCOutlookBarPane objeto 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);

De telefonarCMFCBaseTabCtrl::AddTab Para adicionar cada nova guia. conjunto o bDetachable parâmetro para FALSE Para tornar uma página não-removíveis. Ou, use CMFCOutlookBarTabCtrl::AddControl Para adicionar páginas removíveis.
```
pOutlookBar->AddTab (&m_wndOutlookPane, "General", (UINT) -1, TRUE); 
```
Para adicionar um CWnd-derivado (por exemplo, o controle Classe CMFCShellTreeCtrl) sistema autônomo uma guia, criar o controle e a telefonar CMFCBaseTabCtrl::AddTab para adicioná-la à BAR do Outlook.

Observação:
Você deve Use IDs de controle exclusivo para cada Classe CMFCOutlookBarPane objeto e para cada CWnd-derivados do objeto.

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

Modo do Outlook 2003

No modo do Outlook 2003, os botões de guia são posicionados na parte inferior do painel da BAR do Outlook.Quando não há espaço suficiente para exibir sistema autônomo botões, eles são exibidos sistema autônomo ícones em uma área semelhantes a barra de ferramentas na parte inferior do painel.

Use CMFCOutlookBar::SetMode2003 Para ativar o modo do Outlook 2003. Use CMFCOutlookBarTabCtrl::SetToolbarImageList Para conjunto o bitmap que contém os ícones que são exibidos na parte inferior da BAR do Outlook. Os ícones no bitmap devem ser solicitados pelo índice de tabulação.