Compartilhar via

Classe CMFCOutlookBarTabCtrl

  • Artigo

Um controle guia que tem a aparência visual do Painel de Navegação no Microsoft Outlook. Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

Sintaxe

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Membros

Construtores públicos

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

Métodos públicos

Nome Descrição
CMFCOutlookBarTabCtrl::AddControl Adiciona um controle do Windows como uma nova guia à barra do Outlook.
CMFCOutlookBarTabCtrl::CalcRectEdit Chamado pela estrutura para determinar as dimensões da caixa de edição que aparece quando um usuário renomeia uma guia. (Substitui CMFCBaseTabCtrl::CalcRectEdit.)
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons Chamado pela estrutura durante operações de redimensionamento para determinar se menos botões da página da guia da barra do Outlook podem ser exibidos do que os que estão visíveis.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons Chamado pela estrutura durante operações de redimensionamento para determinar se mais botões da página da guia da barra do Outlook podem ser exibidos do que os que estão visíveis.
CMFCOutlookBarTabCtrl::Create Cria o controle guia da barra do Outlook.
CMFCOutlookBarTabCtrl::CreateObject Usado pela estrutura para criar uma instância dinâmica desse tipo de classe.
CMFCOutlookBarTabCtrl::EnableAnimation Especifica se a animação que ocorre durante a mudança entre guias ativas está habilitada.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit Especifica se um usuário pode modificar os rótulos de texto nos botões de guia da barra do Outlook. (Substitui CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCOutlookBarTabCtrl::EnableScrollButtons Chamado pela estrutura para habilitar botões que permitem que o usuário role os botões no painel da barra do Outlook.
CMFCOutlookBarTabCtrl::FindTargetWnd Identifica um painel que contém um ponto especificado. (Substitui CMFCBaseTabCtrl::FindTargetWnd.)
CMFCOutlookBarTabCtrl::GetBorderSize Retorna o tamanho da borda do controle guia do Outlook.
CMFCOutlookBarTabCtrl::GetTabArea Recupera o tamanho e a posição da área guia do controle guia. (Substitui CMFCBaseTabCtrl::GetTabArea.)
CMFCOutlookBarTabCtrl::GetThisClass Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation Determina se a animação que ocorre durante a mudança entre guias ativas está habilitada.
CMFCOutlookBarTabCtrl::IsMode2003 Determina se o controle guia da barra do Outlook está em um modo que emula o Microsoft Outlook 2003.
CMFCOutlookBarTabCtrl::IsPtInTabArea Determina se um ponto está dentro da área da guia. (Substitui CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCOutlookBarTabCtrl::IsTabDetachable Determina se uma guia é desanexável. (Substitui CMFCBaseTabCtrl::IsTabDetachable.)
CMFCOutlookBarTabCtrl::OnChangeTabs Chamado pela estrutura quando uma guia é inserida ou removida. (Substitui CMFCBaseTabCtrl::OnChangeTabs.)
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons Chamado pela estrutura para reduzir o número de botões de páginas de guia visíveis.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons Chamado pela estrutura para aumentar o número de botões de páginas de guia visíveis.
CMFCOutlookBarTabCtrl::OnShowOptions Exibe a caixa de diálogo Opções do Painel de Navegação.
CMFCOutlookBarTabCtrl::RecalcLayout Recalcula o layout interno do controle guia. (Substitui CMFCBaseTabCtrl::RecalcLayout.)
CMFCOutlookBarTabCtrl::SetActiveTab Define a guia ativa. (Substitui CMFCBaseTabCtrl::SetActiveTab.)
CMFCOutlookBarTabCtrl::SetBorderSize Define o tamanho da borda do controle guia do Outlook.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign Define o alinhamento dos rótulos de texto nos botões de guia da barra do Outlook.
CMFCOutlookBarTabCtrl::SetToolbarImageList Define o bitmap que contém os ícones exibidos na parte inferior da barra do Outlook no modo do Outlook 2003 (consulte a classe CMFCOutlookBar).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Comentários

Para criar uma barra do Outlook com suporte para encaixe, use um objeto CMFCOutlookBar para hospedar o controle da guia da barra do Outlook. Para obter mais informações, consulte Classe CMFCOutlookBar.

Exemplo

O exemplo a seguir demonstra como inicializar um objeto CMFCOutlookBarTabCtrl e usar vários métodos na classe CMFCOutlookBarTabCtrl. O exemplo mostra como habilitar a edição in loco do rótulo de texto nos botões da página da guia da barra do Outlook, habilitar a animação, habilitar alças de rolagem que permitem que o usuário role os botões no painel da barra do Outlook, definir o tamanho da borda do controle guia do Outlook e definir o alinhamento dos rótulos de texto nos botões guia da barra do Outlook. Este snippet de código faz parte do exemplo de demonstração do Outlook.

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();

pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

Hierarquia de herança

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCOutlookBarTabCtrl

Requisitos

Cabeçalho: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Adiciona um controle do Windows como uma nova guia à barra do Outlook.

void AddControl(
    CWnd* pWndCtrl,
    LPCTSTR lpszName,
    int nImageID=-1,
    BOOL bDetachable=TRUE,
    DWORD dwControlBarStyle=AFX_CBRS_FLOAT |  AFX_CBRS_CLOSE | AFX_CBRS_RESIZE |  CBRS_AFX_AUTOHIDE);

Parâmetros

pWndCtrl
[in] Um ponteiro para um controle a ser adicionado.

lpszName
[in] Especifica o nome da guia.

bDetachable
[in] Se TRUE, a página será criada como desanexável.

nImageID
[in] Índice de imagens na lista de imagens internas para a imagem a ser exibida na nova guia.

dwControlBarStyle
[in] Especifica o estilo AFX_ CBRS_* para os painéis de encaixe encapsulados.

Comentários

Use essa função para adicionar um controle como uma nova página de uma barra do Outlook.

Essa função chama CMFCBaseTabCtrl::AddTab internamente.

Se você definir bDetachable como TRUE, AddControl criará internamente um objeto CDockablePaneAdapter e encapsulará o controle adicionado. Ela define automaticamente a classe de runtime da janela com guias como a classe de runtime de CMFCOutlookBar e a classe de runtime do quadro flutuante como CMultiPaneFrameWnd.

Exemplo

O seguinte exemplo demonstra como usar o método AddControl na classe CMFCOutlookBarTabCtrl. Este snippet de código faz parte do exemplo de demonstração do Outlook.

// CMFCOutlookBarTabCtrl* pOutlookBar
// DWORD dwStyle = AFX_CBRS_FLOAT | AFX_CBRS_AUTOHIDE | AFX_CBRS_RESIZE
// CMFCOutlookBarPane pane1
// The third parameter is the image index.
pOutlookBar->AddControl(&pane1, _T("General"), 0, TRUE, dwStyle);

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

Chamado pela estrutura durante operações de redimensionamento para determinar se menos botões da página da guia da barra do Outlook podem ser exibidos do que os que estão visíveis.

virtual BOOL CanShowFewerPageButtons() const;

Valor de retorno

TRUE se houver mais de um botão; caso contrário, FALSE.

Comentários

O controle guia da barra do Outlook adiciona ou remove guias dinamicamente da exibição dependendo da quantidade de espaço disponível. Esse método é usado pela estrutura para ajudar no processo.

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Chamado pela estrutura durante operações de redimensionamento para determinar se mais botões da página da guia da barra do Outlook podem ser exibidos do que os que estão visíveis.

virtual BOOL CanShowMorePageButtons() const;

Valor de retorno

TRUE se houver botões que não estão visíveis no momento; caso contrário, FALSE.

Comentários

O controle guia da barra do Outlook adiciona ou remove guias dinamicamente da exibição dependendo da quantidade de espaço disponível. Esse método é usado pela estrutura para ajudar no processo.

CMFCOutlookBarTabCtrl::Create

Cria o controle guia da barra do Outlook.

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

Parâmetros

rect
[in] Especifica o tamanho e a posição iniciais, em pixels.

pParentWnd
[in] Aponta para a janela pai. Não pode ser NULL.

Nid
[entrada] A ID de controle.

Valor de retorno

Diferente de zero se o controle foi criado com êxito; caso contrário, 0.

Comentários

Normalmente, os controles de guia da barra do Outlook são criados quando a classe CMFCOutlookBar controla a mensagem WM_CREATE do processo.

CMFCOutlookBarTabCtrl::EnableAnimation

Especifica se a animação que ocorre durante a mudança entre guias ativas está habilitada.

static void EnableAnimation(BOOL bEnable=TRUE);

Parâmetros

bEnable
[in] Especifica se a animação deve ser habilitada ou desabilitada.

Comentários

Chame essa função para habilitar e desabilitar a animação. Quando o usuário abre uma página da guia, a legenda da página desliza para cima ou para baixo quando a animação está habilitada. Quando a animação está desabilitada, a página fica ativa imediatamente.

Por padrão, a animação está habilitada.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Especifica se um usuário pode modificar os rótulos de texto nos botões da página da guia da barra do Outlook.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parâmetros

bEnable
Se TRUE, habilitar a edição in loco do rótulo de texto. Se FALSE, desabilitar a edição in loco.

Comentários

Chame essa função para habilitar ou desabilitar a edição in loco de rótulos de texto nos botões da página da guia. Por padrão, a edição in loco está desabilitada.

CMFCOutlookBarTabCtrl::EnableScrollButtons

Chamado pela estrutura para habilitar alças de rolagem que permitem que o usuário role os botões no painel da barra do Outlook.

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

Parâmetros

bEnable
[in] Determina se os botões de rolagem são exibidos.

bIsUp
[in] Determina se a barra de rolagem superior é exibida.

bIsDown
[in] Determina se a barra de rolagem inferior é exibida.

Comentários

Habilita a exibição dos botões de rolagem. Esse método é chamado pela estrutura quando a guia ativa é alterada para restaurar os botões de rolagem.

CMFCOutlookBarTabCtrl::GetBorderSize

Retorna o tamanho da borda do controle guia do Outlook.

int GetBorderSize() const;

Valor de retorno

O tamanho da borda, em pixels.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

Valor de retorno

Comentários

CMFCOutlookBarTabCtrl::IsAnimation

Especifica se a animação que ocorre durante a mudança entre guias ativas está habilitada.

static BOOL IsAnimation();

Valor de retorno

Diferente de zero se a animação estiver habilitada; caso contrário, 0.

Comentários

Chame a função CMFCOutlookBarTabCtrl::EnableAnimation para habilitar ou desabilitar a animação.

CMFCOutlookBarTabCtrl::IsMode2003

Determina se o controle guia da barra do Outlook está em um modo que emula o Microsoft Outlook 2003.

BOOL IsMode2003() const;

Valor de retorno

TRUE se o controle guia da barra do Outlook estiver no modo do Outlook 2003; caso contrário, FALSE;

Comentários

Esse valor é definido por CMFCOutlookBar::SetMode2003.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Chamado pela estrutura para reduzir o número de botões de páginas de guia visíveis.

virtual void OnShowFewerPageButtons();

Comentários

Esse método ajusta o número de botões de guia da página visíveis quando o controle é redimensionado.

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Chamado pela estrutura para aumentar o número de botões de páginas de guia visíveis.

virtual void OnShowMorePageButtons();

Comentários

Esse método ajusta o número de botões da página da guia visíveis quando o controle é redimensionado.

CMFCOutlookBarTabCtrl::OnShowOptions

Exibe a caixa de diálogo Opções do Painel de Navegação.

virtual void OnShowOptions();

Comentários

A caixa de diálogo Opções do Painel de Navegação permite que o usuário selecione quais botões da página da guia devem ser exibidos e a ordem na qual eles são exibidos.

Esse método é chamado pela estrutura quando o usuário seleciona o item de menu Opções do Painel de Navegação no menu de personalização do controle.

CMFCOutlookBarTabCtrl::SetActiveTab

Define a guia ativa, que é a guia que está aberta, com o conteúdo visível.

virtual BOOL SetActiveTab(int iTab);

Parâmetros

iTab
[in] O índice baseado em zero de uma guia a ser aberta.

Valor de retorno

Diferente de zero se a guia especificada tiver sido aberta com êxito; caso contrário, 0.

Comentários

O efeito visual da definição da guia ativa depende de você ter habilitado a animação. Para obter mais informações, consulte CMFCOutlookBarTabCtrl::EnableAnimation.

CMFCOutlookBarTabCtrl::SetBorderSize

Define o tamanho da borda do controle guia do Outlook.

void SetBorderSize(int nBorderSize);

Parâmetros

nBorderSize
[in] Especifica o novo tamanho da borda em pixels.

Comentários

Define o novo tamanho da borda e recalcula o layout da janela do Outlook.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Define o alinhamento dos rótulos de texto nos botões de guia da barra do Outlook.

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

Parâmetros

uiAlign
[in] Especifica o alinhamento do texto.

bRedraw
[in] Se TRUE, a janela do Outlook será redesenhada.

Comentários

Use essa função para alterar o alinhamento de texto dos botões da página.

uiAlign pode ter um dos seguintes valores:

Constante Significado
TA_LEFT Alinhamento à esquerda
TA_CENTER Alinhamento central
TA_RIGHT Alinhamento à direita

O valor padrão é TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

Define o bitmap que contém os ícones exibidos na parte inferior da barra do Outlook no modo do Outlook 2003.

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

Parâmetros

uiID
[in] Especifica a ID do recurso da imagem a ser carregada.

cx
[in] Especifica a largura de uma imagem na lista de imagens, em pixels.

clrTransp
[in] Um valor RGB que especifica a cor transparente.

Valor de retorno

Retornará TRUE se bem-sucedido; caso contrário, FALSE.

Comentários

Use essa função para anexar uma lista de imagens cujas imagens serão exibidas nos botões da barra de ferramentas no modo do Microsoft Office 2003. Os índices de imagens devem ser correspondentes aos índices de páginas.

Esse método não deverá ser chamado se não estiver no modo do Microsoft Office 2003. Para obter mais informações, consulte Classe CMFCOutlookBar.

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

Parâmetros

[in] nVisiblePageButtons

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CMFCBaseTabCtrl
Classe CMFCOutlookBar
Classe CMFCOutlookBarPane