Partilhar via

Classe CMFCOutlookBarPane

  • Artigo

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

Um controle derivado de CMFCToolBar Class que pode ser inserido em uma barra do Outlook (CMFCOutlookBar Class). O painel de barras do Outlook contém uma coluna de botões grandes. O usuário poderá rolar para cima e para baixo na lista de botões se ela for maior que o painel. Quando o usuário destaca um painel de barras do Outlook da barra do Outlook, ele pode flutuar ou encaixar na janela de quadro principal.

Sintaxe

class CMFCOutlookBarPane : public CMFCToolBar

Membros

Construtores públicos

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

Métodos públicos

Nome Descrição
CMFCOutlookBarPane::AddButton Adiciona um botão ao painel de barras do Outlook.
CMFCOutlookBarPane::CanBeAttached Determina se o painel pode ser encaixado a outro painel ou janela de quadro. (Substitui CBasePane::CanBeAttached.)
CMFCOutlookBarPane::CanBeRestored Determina se o sistema pode restaurar o estado original de uma barra de ferramentas após a personalização. (Substitui CMFCToolBar::CanBeRestored.)
CMFCOutlookBarPane::ClearAll Libera os recursos usados pelas imagens no painel de barras do Outlook.
CMFCOutlookBarPane::Create Cria o painel de barras do Outlook.
CMFCOutlookBarPane::CreateObject Usado pela estrutura para criar uma instância dinâmica desse tipo de classe.
CMFCOutlookBarPane::Dock Chamado pela estrutura para encaixar o painel de barras do Outlook. (Substitui CPane::Dock.)
CMFCOutlookBarPane::EnablePageScrollMode Especifica se as setas de rolagem no painel de barras do Outlook avançam a lista de botões por página ou por botão.
CMFCOutlookBarPane::GetRegularColor Retorna a cor de texto regular (não selecionada) do painel de barras do Outlook.
CMFCOutlookBarPane::GetThisClass Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe.
CMFCOutlookBarPane::IsBackgroundTexture Determina se há uma imagem de plano de fundo carregada para o painel de barras do Outlook.
CMFCOutlookBarPane::IsChangeState Determina se um painel flutuante pode ser encaixado. (Substitui CPane::IsChangeState.)
CMFCOutlookBarPane::IsDrawShadedHighlight Determina se a borda do botão é sombreada quando um botão é realçado e uma imagem de plano de fundo é exibida.
CMFCOutlookBarPane::OnBeforeFloat Chamado pela estrutura quando um painel está prestes a flutuar. (Substitui CPane::OnBeforeFloat.)
CMFCOutlookBarPane::RemoveButton Remove o botão que tem uma ID de comando especificada.
CMFCOutlookBarPane::RestoreOriginalstate Restaura o estado original de uma barra de ferramentas. (Substitui CMFCToolBar::RestoreOriginalState.)
CMFCOutlookBarPane::SetBackColor Define a cor do plano de fundo.
CMFCOutlookBarPane::SetBackImage Define a imagem do plano de fundo.
CMFCOutlookBarPane::SetDefaultState Redefine o painel de barras do Outlook para o conjunto original de botões.
CMFCOutlookBarPane::SetExtraSpace Define o número de pixels de preenchimento usados ao redor dos botões no painel de barras do Outlook.
CMFCOutlookBarPane::SetTextColor Define as cores do texto regular e realçado no painel de barras do Outlook.
CMFCOutlookBarPane::SetTransparentColor Define a cor transparente para o painel de barras do Outlook.
CMFCOutlookBarPane::SmartUpdate Usado internamente para atualizar a barra do Outlook. (Substitui CMFCToolBar::SmartUpdate.)

Métodos protegidos

Nome Descrição
CMFCOutlookBarPane::EnableContextMenuItems Especifica quais itens de menu de atalho são exibidos no modo de personalização.
CMFCOutlookBarPane::RemoveAllButtons Remove todos os botões do painel de barras do Outlook. (Substitui CMFCToolBar::RemoveAllButtons.)

Comentários

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

Para obter um exemplo de uma barra do Outlook, consulte o projeto de amostra do OutlookDemo.

Exemplo

O exemplo a seguir demonstra como usar vários métodos da classe CMFCOutlookBarPane. O exemplo mostra como criar um painel de barras do Outlook, habilitar o modo de rolagem de página, habilitar o encaixe e definir a cor do plano de fundo da barra do Outlook. Esse snippet de código faz parte do exemplo com várias exibições do Outlook.

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

Requisitos

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
[in] Especifica o identificador de recurso de um bitmap.

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

iIdCommand
[in] Especifica a ID do controle de botão.

iInsertAt
[in] Especifica o índice baseado em zero na página da barra do Outlook na qual inserir o botão.

uiLabel
[in] Uma ID de recurso de cadeia de caracteres.

szBmpFileName
[in] Especifica o nome do arquivo de imagem de disco a ser carregado.

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

hBmp
[in] Um identificador para o bitmap de um botão.

hIcon
[in] Um identificador para um ícone de botões.

Valor de retorno

TRUE se um botão foi adicionado com êxito. Caso contrário, FALSE.

Comentários

Use esse método para inserir um novo botão na página de uma barra do Outlook. A imagem do botão pode ser carregada dos recursos do aplicativo ou de um arquivo de disco.

Se a ID da página especificada por uiPageID for -1, o botão será inserido na primeira página.

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

CMFCOutlookBarPane::CanBeAttached

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

virtual BOOL CanBeAttached() const;

Valor de retorno

Comentários

CMFCOutlookBarPane::ClearAll

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

void ClearAll();

Comentários

Esse método chama diretamente 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
[in] Especifica a janela pai do controle do painel de barras do Outlook. Não pode ser NULL.

dwStyle
[in] O estilo da janela. Para uma lista de estilos de janela, confira Estilos de janela.

uiID
[entrada] A ID de controle. Deve ser exclusivo para habilitar o salvamento do estado do controle.

dwControlBarStyle
[in] Especifica estilos especiais que definem o comportamento do controle do painel de barras do Outlook quando ele é desanexado da barra do Outlook.

Valor de retorno

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

Comentários

Para construir um objeto CMFCOutlookBarPane, primeiro chame o construtor e, em seguida, chame Create, o que cria o controle do painel de barras do Outlook e o anexa ao objeto CMFCOutlookBarPane.

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

CMFCOutlookBarPane::EnableContextMenuItems

Especifica quais itens de menu de atalho são exibidos no modo de personalização.

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

Parâmetros

pButton
[in] Um ponteiro para um botão de barra de ferramentas em que um usuário clicou.

pPopup
[in] Um ponteiro para o menu de atalho.

Valor de retorno

Retornará TRUE se o menu de atalho precisar ser exibido; caso contrário, FALSE.

Comentários

Substitua esse método para modificar o menu de atalho padrão da estrutura que a estrutura exibe no modo de personalização.

A implementação padrão verifica o modo de personalização (CMFCToolBar::IsCustomizeMode) e, se ele estiver definido como TRUE, desabilitará todos os itens do menu de atalho, exceto Excluir. Em seguida, ele apenas passa os parâmetros de entrada para CMFCToolBar::EnableContextMenuItems.

Observação

Menu de contexto é um sinônimo para o menu de atalho.

CMFCOutlookBarPane::EnablePageScrollMode

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

void EnablePageScrollMode(BOOL bPageScroll=TRUE);

Parâmetros

bPageScroll
[in] Se TRUE, habilite o modo de rolagem de página. Se FALSE, desabilite o modo de rolagem de página.

CMFCOutlookBarPane::GetRegularColor

Retorna a cor de texto regular (não selecionada) do painel de barras do Outlook.

DECLARE_MESSAGE_MAPCOLORREF GetRegularColor() const;

Valor de retorno

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

Comentários

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

CMFCOutlookBarPane::IsBackgroundTexture

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

BOOL IsBackgroundTexture() const;

Valor de retorno

TRUE se houver uma imagem de plano de fundo a ser exibida; caso contrário, FALSE.

Comentários

Você pode adicionar uma imagem em segundo plano chamando a função CMFCOutlookBarPane::SetBackImage.

Se não houver nenhuma imagem de plano de fundo, o plano de fundo será pintado com uma cor especificada usando CMFCOutlookBarPane::SetBackColor.

CMFCOutlookBarPane::IsDrawShadedHighlight

Determina se a borda do botão é sombreada quando um botão é realçado e uma imagem de plano de fundo é exibida.

BOOL IsDrawShadedHighlight() const;

Valor de retorno

TRUE se as bordas do botão estiverem sombreadas; caso contrário, FALSE.

CMFCOutlookBarPane::RemoveAllButtons

Remove todos os botões do painel de barras do Outlook.

virtual void RemoveAllButtons();

CMFCOutlookBarPane::RemoveButton

Remove o botão que tem uma ID de comando especificada.

BOOL RemoveButton(UINT iIdCommand);

Parâmetros

iIdCommand
[in] Especifica a ID de comando de um botão para remover.

Valor de retorno

TRUE se o botão foi removido com êxito; FALSE se a ID de comando especificada não for válida.

CMFCOutlookBarPane::SetBackColor

Define a cor do plano de fundo da barra do Outlook.

void SetBackColor(COLORREF color);

Parâmetros

color
[in] Especifica a nova cor da tela de fundo.

Comentários

Chame essa função para definir a cor do plano de fundo atual para a barra do Outlook. A cor do plano de fundo será usada somente se não houver nenhuma imagem de plano de fundo.

CMFCOutlookBarPane::SetBackImage

Define a imagem do plano de fundo.

void SetBackImage(UINT uiImageID);

Parâmetros

uiImageID
[in] Especifica a ID do recurso de imagem.

Comentários

Chame esse método para definir a imagem de plano de fundo da barra do Outlook. A lista de imagens de plano de fundo é gerenciada pelo objeto CMFCToolBarImages Class inserido.

CMFCOutlookBarPane::SetDefaultState

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

void SetDefaultState();

Comentários

Esse método restaura os botões da barra do Outlook para o conjunto original. Esse método é semelhante a CMFCOutlookBarPane::RestoreOriginalstate, exceto que ele não dispara um novo redesenho do painel de barras do Outlook.

CMFCOutlookBarPane::SetExtraSpace

Define o número de pixels de preenchimento usados ao redor dos botões no painel de barras do Outlook.

void SetExtraSpace()

CMFCOutlookBarPane::SetTextColor

Define as cores do texto regular e realçado no painel de barras do Outlook.

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

Parâmetros

clrRegText
[in] Especifica a nova cor do texto não selecionado.

clrSelText
[in] Especifica a nova cor do texto selecionado.

CMFCOutlookBarPane::SetTransparentColor

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

void SetTransparentColor(COLORREF color);

Parâmetros

color
Especifica a nova cor transparente.

Comentários

A cor transparente é necessária para exibir imagens transparentes. Qualquer ocorrência dessa cor em uma imagem é pintada com a cor do plano de fundo. Não há mesclagem de imagens de plano de fundo e primeiro plano.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCToolBar
Classe CMFCOutlookBar
Classe CMFCOutlookBarTabCtrl