CMFCOutlookBarPane Classe

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Um controlo derivado da classe CMFCToolBar que pode ser inserido numa barra do Outlook ( CMFCOutlookBar Class). O painel de barras do Outlook contém uma coluna de botões grandes. O utilizador pode percorrer a lista de botões para cima e para baixo se for maior do que o painel. Quando o utilizador desliga um painel de barras do Outlook da barra do Outlook, este pode flutuar ou acoplar-se na janela principal do frame.

Sintaxe

class CMFCOutlookBarPane : public CMFCToolBar

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Observações

Para informações sobre como implementar uma barra do Outlook, consulte CMFCOutlookBar Class.

Para um exemplo de barra do Outlook, veja o projeto de exemplo OutlookDemo.

Example

O exemplo seguinte demonstra como usar vários métodos da CMFCOutlookBarPane aula. O exemplo mostra como criar um painel de barra do Outlook, ativar o modo de deslocamento de página, ativar o docking e definir a cor de fundo da barra do Outlook. Este excerto de código faz parte do exemplo Outlook Multi Views.

CMFCOutlookBarPane m_wndShortcutsPane1;

CImageList images;
images.Create(IDB_SHORTCUTS, 32, 0, RGB(255, 0, 255));

// Create first page:
m_wndShortcutsPane1.Create(&m_wndShortcutsBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_SHORTCUTS_PANE_1);
// The this pointer points to a CMainFrame class which extends the CFrameWnd class
m_wndShortcutsPane1.SetOwner(this);
m_wndShortcutsPane1.EnableTextLabels();
m_wndShortcutsPane1.EnableDocking(CBRS_ALIGN_ANY);
m_wndShortcutsPane1.EnablePageScrollMode();
m_wndShortcutsPane1.SetBackColor(RGB(0, 255, 0));

m_wndShortcutsPane1.AddButton(images.ExtractIcon(0), _T("View 1"), ID_SHORTCUT_1);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(1), _T("View 2"), ID_SHORTCUT_2);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(2), _T("View 3"), ID_SHORTCUT_3);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(3), _T("View 4"), ID_SHORTCUT_4);

Hierarquia de herança

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCOutlookBarPane

Requerimentos

Cabeçalho: afxoutlookbarpane.h

CMFCOutlookBarPane::AddButton

Adiciona um botão ao painel de barras do Outlook.

BOOL AddButton(
    UINT uiImage,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    UINT uiImage,
    UINT uiLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    LPCTSTR szBmpFileName,
    LPCTSTR szLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HBITMAP hBmp,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HICON hIcon,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1,
    BOOL bAlphaBlend=FALSE);

Parâmetros

uiImage
[dentro] Especifica o identificador de recurso de um bitmap.

lpszLabel
[dentro] Especifica o texto do botão.

iIdCommand
[dentro] Especifica o ID do controlo do botão.

iInsertAt
[dentro] Especifica o índice em base zero na página da barra do Outlook onde se deve inserir o botão.

uiLabel
[dentro] Um ID de recurso de cadeia.

szBmpFileName
[dentro] Especifica o nome do ficheiro de imagem do disco a carregar.

szLabel
[dentro] Especifica o texto do botão.

hBmp
[dentro] Um handle para o bitmap de um botão.

hIcon
[dentro] Uma pega para um ícone de botões.

Valor de retorno

VERDADEIRO se um botão foi adicionado com sucesso; caso contrário, FALSO.

Observações

Use este método para inserir um novo botão na página da barra do Outlook. A imagem do botão pode ser carregada tanto a partir dos recursos da aplicação como a partir de um ficheiro de disco.

Se o ID da página especificado pelo uiPageID for -1, o botão é inserido na primeira página.

Se o índice especificado pelo iInsertAt for -1, o botão é adicionado no final da página.

CMFCOutlookBarPane::PodeSer Anexado

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

virtual BOOL CanBeAttached() const;

Valor de retorno

Observações

CMFCOutlookBarPane::ClearAll

Liberta os recursos usados pelas imagens no painel de barras do Outlook.

void ClearAll();

Observações

Este método chama diretamente o CMFCToolBarImages::Clear, que é chamado nas imagens usadas pelo painel de barras do Outlook.

CMFCOutlookBarPane::Create

Cria o painel de barras do Outlook.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT uiID=(UINT)-1,
    DWORD dwControlBarStyle=0);

Parâmetros

pParentWnd
[dentro] Especifica a janela pai do controlo do painel de barras do Outlook. Não pode ser NULO.

dwStyle
[dentro] O estilo da janela. Para uma lista de estilos de janelas, consulte Estilos de Janela.

uiID
[dentro] O ID de controlo. Deve ser único para permitir a gravação do estado do controlo.

dwControlBarStyle
[dentro] Especifica estilos especiais que definem o comportamento do controlo do painel da barra do Outlook quando este está separado da barra do Outlook.

Valor de retorno

TRUE se o método foi bem-sucedido; caso contrário, FALSO.

Observações

Para construir um CMFCOutlookBarPane objeto, primeiro chama o construtor, e depois chama Create, que cria o controlo do painel de barras do Outlook e o anexa ao CMFCOutlookBarPane objeto.

Para mais informações, dwControlBarStyle consulte CBasePane::CreateEx.

CMFCOutlookBarPane::EnableContextMenuItems

Especifica quais os itens do menu de atalho que são exibidos em modo de personalização.

virtual BOOL EnableContextMenuItems(
    CMFCToolBarButton* pButton,
    CMenu* pPopup);

Parâmetros

pButton
[dentro] Um apontador para um botão da barra de ferramentas que o utilizador clicava.

pPopup
[dentro] Um apontador para o menu de atalhos.

Valor de retorno

Retorna TRUE se o menu de atalhos for exibido; caso contrário, FALSO.

Observações

Substitua este método para modificar o menu de atalhos padrão do framework que o framework exibe no modo de personalização.

A implementação padrão verifica o modo de personalização ( CMFCToolBar::IsCustomizeMode) e, se estiver definido para TRUE, desativa todos os itens do menu de atalho, exceto Delete. Depois, passa apenas os parâmetros de entrada para CMFCToolBar::EnableContextMenuItems.

CMFCOutlookBarPane::EnablePageScrollMode

Especifica se as setas de scroll no painel de barras do Outlook avançam a lista de botões página a página, ou botão a botão.

void EnablePageScrollMode(BOOL bPageScroll=TRUE);

Parâmetros

bPageScroll
[dentro] Se for VERDADEIRO, ativa o modo de scroll de página. Se FALSE, desative o modo de scroll de página.

CMFCOutlookBarPane::GetRegularColor

Devolve a cor de texto normal (ou seja, não selecionada) do painel da barra do Outlook.

DECLARE_MESSAGE_MAPCOLORREF GetRegularColor() const;

Valor de retorno

A cor do texto atual como um valor de cor RGB.

Observações

Use o CMFCOutlookBarPane::SetTextColor para definir a cor de texto atual (normal e selecionada) da barra do Outlook. Pode obter a cor padrão do texto chamando a função GetSysColor com o índice de COLOR_WINDOW.

CMFCOutlookBarPane::IsBackgroundTexture

Determina se há uma imagem de fundo carregada para o painel de barras do Outlook.

BOOL IsBackgroundTexture() const;

Valor de retorno

TRUE se houver imagem de fundo para mostrar; caso contrário, FALSO.

Observações

Pode adicionar uma imagem de fundo chamando a função CMFCOutlookBarPane::SetBackImage .

Se não houver imagem de fundo, o fundo é pintado com uma cor especificada usando CMFCOutlookBarPane::SetBackColor.

CMFCOutlookBarPane::IsDrawShadedHighlight

Determina se a borda do botão é sombreada quando um botão é destacado e uma imagem de fundo é exibida.

BOOL IsDrawShadedHighlight() const;

Valor de retorno

VERDADEIRO se as bordas dos botões estiverem sombreadas; caso contrário, FALSO.

CMFCOutlookBarPane::RemoveAllButtons

Remove todos os botões do painel da barra do Outlook.

virtual void RemoveAllButtons();

CMFCOutlookBarPane::RemoveButton

Remove o botão que tem um ID de comando especificado.

BOOL RemoveButton(UINT iIdCommand);

Parâmetros

iIdCommand
[dentro] Especifica o ID do comando de um botão a remover.

Valor de retorno

TRUE se o botão foi removido com sucesso; FALSE se o ID do comando especificado não for válido.

CMFCOutlookBarPane::SetBackColor

Define a cor de fundo da barra do Outlook.

void SetBackColor(COLORREF color);

Parâmetros

cor
[dentro] Especifica a nova cor de fundo.

Observações

Chama esta função para definir a cor de fundo atual da barra do Outlook. A cor de fundo é usada apenas se não houver imagem de fundo.

CMFCOutlookBarPane::ImageRetroRetro

Define a imagem de fundo.

void SetBackImage(UINT uiImageID);

Parâmetros

uiImageID
[dentro] Especifica o ID do recurso da imagem.

Observações

Chame este método para definir a imagem de fundo da barra do Outlook. A lista de imagens de fundo é gerida pelo objeto CMFCToolBarImages Class.

CMFCOutlookBarPane::SetDefaultState

Reinicia o painel de barras do Outlook para o conjunto original de botões.

void SetDefaultState();

Observações

Este método restaura os botões da barra do Outlook ao conjunto original. Este método é como CMFCOutlookBarPane::RestoreOriginalstate, exceto que não desencadeia um redesenho do painel de barras do Outlook.

CMFCOutlookBarPane::SetExtraSpace

Define o número de píxeis de preenchimento usados à volta dos botões no painel da barra do Outlook.

void SetExtraSpace()

CMFCOutlookBarPane::SetTextColor

Define as cores do texto normal e do texto destacado no painel de barras do Outlook.

void SetTextColor(
    COLORREF clrRegText,
    COLORREF clrSelText=0);

Parâmetros

clrRegText
[dentro] Especifica a nova cor para texto não selecionado.

clrSelText
[dentro] Especifica a nova cor para o texto selecionado.

CMFCOutlookBarPane::SetTransparentColor

Define a cor transparente para o painel de barras do Outlook.

void SetTransparentColor(COLORREF color);

Parâmetros

cor
Especifica a nova cor transparente.

Observações

A cor transparente é necessária para exibir imagens transparentes. Qualquer ocorrência desta cor numa imagem é pintada com a cor de fundo. Não há mistura de imagens de fundo e primeiro plano.

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCToolBar
Classe CMFCOutlookBar
Classe CMFCOutlookBarTabCtrl