Classe CMFCOutlookBarTabCtrl
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
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 Devolução
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 Devolução
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 Devolução
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 Devolução
O tamanho da borda, em pixels.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
int GetVisiblePageButtons() const;
Valor de Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de