Classe CMFCCaptionBar

Artigo
06/10/2015

Um objeto de CMFCCaptionBar é uma barra de controle que pode exibir três elementos: um botão, um rótulo de texto, e um bitmap. Só pode exibir um elemento de cada tipo de cada vez. Você pode alinhar cada elemento as bordas esquerda ou direita do controle ou o centro. Você também pode aplicar um plano ou um estilo 3D às bordas da parte superior e inferior da barra de título.

class CMFCCaptionBar : public CPane

Membros

Métodos Públicos

Nome	Descrição
CMFCCaptionBar::Create	Cria o controle de barra de título e anexá-la ao objeto de CMFCCaptionBar.
CMFCCaptionBar::DoesAllowDynInsertBefore	Indica se outro painel dinamicamente pode ser inserido entre a barra de título e seu elemento pai. Overrides ( CBasePane::DoesAllowDynInsertBefore.)
CMFCCaptionBar::EnableButton	Habilita ou desabilita o botão na barra de título.
CMFCCaptionBar::GetAlignment	Retorna o alinhamento do elemento especificado.
CMFCCaptionBar::GetBorderSize	Retorna o tamanho da borda da barra de título.
CMFCCaptionBar::GetButtonRect	Recupera o retângulo delimitador de botão na barra de título.
CMFCCaptionBar::GetMargin	Retorna a distância entre a borda dos elementos da barra de título e a borda do controle de barra de título.
CMFCCaptionBar::IsMessageBarMode	Especifica se a barra de título está no modo da barra de mensagens.
CMFCCaptionBar::RemoveBitmap	Remove a imagem de bitmap da barra de título.
CMFCCaptionBar::RemoveButton	Remove o botão da barra de título.
CMFCCaptionBar::RemoveIcon	Remove o ícone da barra de título.
CMFCCaptionBar::RemoveText	Remove o rótulo de texto da barra de título.
CMFCCaptionBar::SetBitmap	Define a imagem de bitmap para a barra de título.
CMFCCaptionBar::SetBorderSize	Defina o tamanho da borda da barra de título.
CMFCCaptionBar::SetButton	Define o botão da barra de título.
CMFCCaptionBar::SetButtonPressed	Especifica se o botão permanece pressionado.
CMFCCaptionBar::SetButtonToolTip	Define a dica de ferramenta para o botão.
CMFCCaptionBar::SetFlatBorder	Defina o estilo de borda da barra de título.
CMFCCaptionBar::SetIcon	Define o ícone para uma barra de título.
CMFCCaptionBar::SetImageToolTip	Define a dica de ferramenta para a imagem para a barra de título.
CMFCCaptionBar::SetMargin	Define a distância entre a borda do elemento da barra de título e a borda do controle de barra de título.
CMFCCaptionBar::SetText	Define o rótulo de texto da barra de título.

Métodos protegidos

Nome	Descrição
CMFCCaptionBar::OnDrawBackground	Chamado pela estrutura para preencher o plano de fundo da barra de título.
CMFCCaptionBar::OnDrawBorder	Chamado pela estrutura para desenhar a borda da barra de título.
CMFCCaptionBar::OnDrawButton	Chamado pela estrutura para desenhar o botão da barra de título.
CMFCCaptionBar::OnDrawImage	Chamado pela estrutura para desenhar uma imagem da barra de título.
CMFCCaptionBar::OnDrawText	Chamado pela estrutura para desenhar o texto da barra de título.

Membros de Dados

Nome	Descrição
CMFCCaptionBar::m_clrBarBackground	A cor do plano de fundo da barra de título.
CMFCCaptionBar::m_clrBarBorder	A cor da borda da barra de título.
CMFCCaptionBar::m_clrBarText	A cor do texto da barra de título.

Comentários

Para criar uma barra de título, siga estas etapas:

Construir o objeto de CMFCCaptionBar . Normalmente, você adicionaria a barra de título a uma classe de janela do quadro.
Chame o método de CMFCCaptionBar::Create para criar o controle de barra de título e para anexá-la ao objeto de CMFCCaptionBar .
Chame CMFCCaptionBar::SetButton, CMFCCaptionBar::SetText, CMFCCaptionBar::SetIcon, e CMFCCaptionBar::SetBitmap para definir os elementos da barra de título.

Quando você definir o elemento de botão, você deve atribuir uma identificação de comando para o botão. Quando o usuário clica no botão, a barra de título rotear mensagens de WM_COMMAND que têm essa identificação para a janela pai do quadro.

A barra de título também pode trabalhar no modo da barra de mensagens, que emula a barra de mensagem que aparece no Microsoft Office 2007 aplicativos. No modo da barra de mensagens, a barra de título exibe um bitmap, uma mensagem, e um botão (que é normalmente uma caixa de diálogo.) Você pode atribuir uma dica de ferramenta para o bitmap.

Para ativar o modo da barra de mensagens, chame CMFCCaptionBar::Create e define o quarto parâmetro () bIsMessageBarMode a TRUE.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe de CMFCCaptionBar . O exemplo a seguir mostra como criar o controle de barra de título, defina uma borda 3D da barra de título, defina a distância, em pixels, entre a borda dos elementos da barra de título e a borda do controle de barra de título, defina o botão da barra de título, defina a dica de ferramenta para o botão, defina o rótulo de texto da barra de título, defina a imagem de bitmap para a barra de título, e defina a dica de ferramenta para a imagem na barra de título. Este trecho de código é parte de Exemplo 2007 de demonstração de MS Office.

 CMFCCaptionBar m_wndMessageBar;


...


BOOL CMainFrame::CreateMessageBar()
{
    // The this pointer points to a CMainFrame class which extends the CFrameWndEx class. 
    if (!m_wndMessageBar.Create(WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS, this, ID_VIEW_MESSAGEBAR, -1, TRUE))
    {
        TRACE0("Failed to create caption bar\n");
        return FALSE;
    }

    m_wndMessageBar.SetFlatBorder( FALSE );
    m_wndMessageBar.SetMargin(10);
    m_wndMessageBar.SetButton(_T("Options..."), ID_TOOLS_OPTIONS, CMFCCaptionBar::ALIGN_LEFT, FALSE);
    m_wndMessageBar.SetButtonToolTip(_T("Click here to see more options"));

    m_wndMessageBar.SetText(_T("Welcome to the MFC MSOffice2007 demonstration!"), CMFCCaptionBar::ALIGN_LEFT);

    m_wndMessageBar.SetBitmap(IDB_INFO, RGB(255, 255, 255), FALSE, CMFCCaptionBar::ALIGN_LEFT);
    m_wndMessageBar.SetImageToolTip(_T("Important"), _T("Please take a look at MSOffice2007Demo source code to learn how to create advanced user interface in minutes."));

    return TRUE;
}