Classe CMFCOutlookBarTabCtrl

Um controlo de separador que tem o aspeto visual do Painel de Navegação do Microsoft Outlook. Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Sintaxe

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Membros

Construtores Públicos

Métodos Públicos

Observações

Para criar uma barra do Outlook que suporte docking, use um CMFCOutlookBar objeto para hospedar o controlo do separador da barra do Outlook. Para mais informações, consulte CMFCOutlookBar Class.

Example

O exemplo seguinte demonstra como inicializar um CMFCOutlookBarTabCtrl objeto e usar vários métodos na CMFCOutlookBarTabCtrl classe. O exemplo mostra como ativar a edição no local do rótulo de texto nos botões da página de separadores da barra do Outlook, ativar a animação, ativar os controlos de scroll que permitem ao utilizador percorrer os botões no painel da barra do Outlook, definir o tamanho da borda do controlo do separador do Outlook e definir o alinhamento dos rótulos de texto nos botões de separador da barra do Outlook. Este excerto 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

Requerimentos

Cabeçalho: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Adiciona um controlo do Windows como um novo separador na 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
[dentro] Um indicador para um controlo para adicionar.

lpszName
[dentro] Especifica o nome da tabulação.

Destacável
[dentro] Se TRUE, a página será criada como destacável.

nImageID
[dentro] Índice de imagem na lista interna de imagens para a imagem a ser exibida no novo separador.

dwControlBarStyle
[dentro] Especifica o estilo AFX_ CBRS_* para painéis de acoplamento enrolados.

Observações

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

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

Se definires bDetachable para TRUE, AddControl cria internamente um CDockablePaneAdapter objeto e envolve o controlo adicional. Define automaticamente a classe de execução da janela separada para a classe de tempo de execução de CMFCOutlookBar e a classe de tempo de execução do quadro flutuante para CMultiPaneFrameWnd.

Example

O exemplo seguinte demonstra como usar o AddControl método na CMFCOutlookBarTabCtrl aula. Este excerto 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 pelo framework durante operações de redimensionamento para determinar se podem ser exibidos menos botões de página de separadores Outlook do que os atualmente visíveis.

virtual BOOL CanShowFewerPageButtons() const;

Valor de retorno

TRUE se houver mais do que um botão; caso contrário, FALSO.

Observações

O controlo de separadores da barra do Outlook adiciona ou remove separadores do ecrã de forma dinâmica, dependendo da quantidade de espaço disponível. Este método é utilizado pelo framework para ajudar nesse processo.

CMFCOutlookBarTabCtrl::PossoMostrarMaisPáginaButtonsButtons

É chamado pelo framework durante operações de redimensionamento para determinar se podem ser exibidos mais botões da barra Outlook do que os atualmente visíveis.

virtual BOOL CanShowMorePageButtons() const;

Valor de retorno

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

Observações

O controlo de separadores na barra do Outlook adiciona ou remove separadores do ecrã dinamicamente, dependendo do espaço disponível. Este método é utilizado pelo framework para ajudar nesse processo.

CMFCOutlookBarTabCtrl::Create

Cria o controlo do separador na barra do Outlook.

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

Parâmetros

retângulo
[dentro] Especifica o tamanho e a posição iniciais, em pixels.

pParentWnd
[dentro] Aponta para a janela dos pais. Não pode ser NULO.

nID
[dentro] O ID de controlo.

Valor de retorno

Não nulo se o controlo tiver sido criado com sucesso; caso contrário, 0.

Observações

Normalmente, os controlos de tabulação da barra 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 troca entre separadores ativos está ativada.

static void EnableAnimation(BOOL bEnable=TRUE);

Parâmetros

bEnable
[dentro] Especifica se a animação deve ser ativada ou desativada.

Observações

Chame esta função para ativar e desativar a animação. Quando o utilizador abre uma página de separador, a legenda da página desliza para cima ou para baixo se a animação estiver ativada. Se a animação estiver desativada, a página torna-se ativa imediatamente.

Por defeito, a animação está ativada.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

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

virtual void EnableInPlaceEdit(BOOL bEnable);

Parâmetros

bEnable
Se TRUE, ativa a edição no local do rótulo de texto. Se FALSE, desative a edição no local.

Observações

Chame esta função para ativar ou desativar a edição no local dos rótulos de texto nos botões da página de separadores. Por defeito, a edição no local está desativada.

CMFCOutlookBarTabCtrl::EnableScrollButtons

É chamado pelo framework para ativar handles de scroll que permitem ao utilizador percorrer botões no painel da barra do Outlook.

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

Parâmetros

bEnable
[dentro] Determina se os botões de scroll são exibidos.

bIsUp
[dentro] Determina se a barra de deslocamento superior é exibida.

bIsDown
[dentro] Determina se a barra de deslocamento inferior é apresentada.

Observações

Permite a visualização dos botões de scroll. Este método é chamado pela framework quando o separador ativo muda para restaurar os botões de scroll.

CMFCOutlookBarTabCtrl::GetBorderSize

Devolve o tamanho da borda do controlo do separador Outlook.

int GetBorderSize() const;

Valor de retorno

O tamanho da borda, em píxeis.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

Valor de retorno

Observações

CMFCOutlookBarTabCtrl::IsAnimation

Especifica se a animação que ocorre durante a troca entre separadores ativos está ativada.

static BOOL IsAnimation();

Valor de retorno

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

Observações

Chame a função CMFCOutlookBarTabCtrl::EnableAnimation para ativar ou desativar a animação.

CMFCOutlookBarTabCtrl::IsMode2003

Determina se o controlo do separador da barra do Outlook está num modo que emule o Microsoft Outlook 2003.

BOOL IsMode2003() const;

Valor de retorno

TRUE se o controlo do separador da barra do Outlook estiver em modo Outlook 2003; caso contrário, FALSO;

Observações

Este valor é definido por CMFCOutlookBar::SetMode2003.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

É chamado pelo framework para diminuir o número de botões de página de separadores que são visíveis.

virtual void OnShowFewerPageButtons();

Observações

Este método ajusta o número de botões de separador de página visíveis quando o controlo é redimensionado.

CMFCOutlookBarTabCtrl::OnMostrarMaisPáginaButtonsButtons

É chamado pelo framework para aumentar o número de botões da página de separadores que são visíveis.

virtual void OnShowMorePageButtons();

Observações

Este método ajusta o número de botões da página de separadores visíveis quando o controlo é redimensionado.

CMFCOutlookBarTabCtrl::OnShowOptions

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

virtual void OnShowOptions();

Observações

A caixa de diálogo Opções do Painel de Navegação permite ao utilizador selecionar quais os botões da página do separador que serão exibidos e a ordem em que são apresentados.

Este método é chamado pelo framework quando o utilizador seleciona o elemento do menu Opções do Painel de Navegação no menu de personalização do controlo.

CMFCOutlookBarTabCtrl::SetActiveTab

Define a conta ativa. O separador ativo é aquele que está aberto, com o seu conteúdo visível.

virtual BOOL SetActiveTab(int iTab);

Parâmetros

iTab
[dentro] O índice em base zero de um separador a ser aberto.

Valor de retorno

Diferente de zero se o separador especificado tiver sido aberto com sucesso; caso contrário, 0.

Observações

O efeito visual de definir o separador ativo depende de teres ou não ativado a animação. Para mais informações, consulte CMFCOutlookBarTabCtrl::EnableAnimation.

CMFCOutlookBarTabCtrl::SetBorderSize

Define o tamanho da borda do controlo do separador Outlook.

void SetBorderSize(int nBorderSize);

Parâmetros

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

Observações

Define o novo tamanho da borda e recalcula a disposição das janelas do Outlook.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Define o alinhamento das etiquetas de texto nos botões de separador da barra do Outlook.

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

Parâmetros

uiAlign
[dentro] Especifica o alinhamento do texto.

bRedraw
[dentro] Se for VERDADE, a janela de perspetiva será redesenhada.

Observações

Use esta função para alterar o alinhamento do texto nos botões da página.

O uiAlign pode ser um dos seguintes valores:

O valor padrão é TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

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

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

Parâmetros

uiID
[dentro] Especifica o ID do recurso da imagem a carregar.

CX
[dentro] Especifica a largura de uma imagem na lista de imagens, em pixels.

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

Valor de retorno

Retorna TRUE se for bem-sucedido; caso contrário, retorna FALSE.

Observações

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

Este método não deve ser chamado se não estiver no modo Microsoft Office 2003. Para mais informações, consulte CMFCOutlookBar Class.

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

Parâmetros

[dentro] nVisiblePageButtonsButtons

Observações

Consulte também

Gráfico de Hierarquia
Classes
CMFCBaseTabCtrl Classe
Classe CMFCOutlookBar
CMFCOutlookBarPane Classe