Classe CMFCCaptionBar

Artigo
08/25/2010

A CMFCCaptionBar objeto é uma BAR de controle que pode exibir três elementos: um botão, um rótulo de texto e um bitmap.Ele pode exibir somente um elemento de cada tipo ao mesmo time.Você pode alinhar cada elemento às bordas esquerdas ou direita do controle ou ao centralizar.Você também pode aplicar um estilo de 3D ou plano às bordas superior e inferior do BAR de legenda.

class CMFCCaptionBar : public CPane

Membros

Métodos públicos

Nome	Descrição
CMFCCaptionBar::criar	Cria a BAR de legenda controle e a anexa o CMFCCaptionBar objeto.
CMFCCaptionBar::DoesAllowDynInsertBefore	Determina se outro painel pode ser inserido dinamicamente entre esse painel e o quadro pai.(Substitui CBasePane::DoesAllowDynInsertBefore.)
CMFCCaptionBar::EnableButton	Ativa ou desativa o botão na BAR de legenda.
CMFCCaptionBar::GetAlignment	Retorna o alinhamento do elemento especificado.
CMFCCaptionBar::GetBorderSize	Retorna o dimensionar da borda da BAR de legenda.
CMFCCaptionBar::GetButtonRect	Recupera o retângulo delimitador do botão no BAR de legenda.
CMFCCaptionBar::GetMargin	Retorna a distância entre a borda do BAR de legenda elementos e a borda do BAR de legenda controle.
CMFCCaptionBar::IsMessageBarMode	Especifica se o BAR de legenda estiver no modo de BAR de mensagem.
CMFCCaptionBar::RemoveBitmap	Remove a imagem de bitmap da BAR de legenda.
CMFCCaptionBar::RemoveButton	Remove o botão do BAR de legenda.
CMFCCaptionBar::RemoveIcon	Remove o ícone da BAR de legenda.
CMFCCaptionBar::RemoveText	Remove o rótulo de texto da BAR de legenda.
CMFCCaptionBar::SetBitmap	Define a imagem de bitmap para o BAR de legenda.
CMFCCaptionBar::SetBorderSize	Define o dimensionar da borda do BAR de legenda.
CMFCCaptionBar::SetButton	Define o botão para o BAR de legenda.
CMFCCaptionBar::SetButtonPressed	Especifica se o botão permanece pressionado.
CMFCCaptionBar::SetButtonToolTip	Define a dica de ferramenta do botão.
CMFCCaptionBar::SetFlatBorder	Define o estilo da borda do BAR de legenda.
CMFCCaptionBar::SetIcon	Define o ícone para um BAR de legenda.
CMFCCaptionBar::SetImageToolTip	Define a dica de ferramenta para a imagem para o BAR de legenda.
CMFCCaptionBar::SetMargin	Define a distância entre a borda do BAR de legenda elemento e a borda do BAR de legenda controle.
CMFCCaptionBar::SetText	Define o rótulo de texto para o BAR de legenda.

Métodos protegidos

Nome	Descrição
CMFCCaptionBar::OnDrawBackground	Chamada pela estrutura para preencher o plano de fundo do BAR de legenda.
CMFCCaptionBar::OnDrawBorder	Chamado pela estrutura para desenhar a borda do BAR de legenda.
CMFCCaptionBar::OnDrawButton	Chamada pela estrutura para desenhar o BAR de legenda botão.
CMFCCaptionBar::OnDrawImage	Chamada pela estrutura para desenhar o BAR de legenda imagem.
CMFCCaptionBar::OnDrawText	Chamada pela estrutura para desenhar o BAR de legenda texto.

Membros de dados

Nome	Descrição
CMFCCaptionBar::m_clrBarBackground	A cor do plano de fundo do BAR de legenda.
CMFCCaptionBar::m_clrBarBorder	A cor da borda do BAR de legenda.
CMFCCaptionBar::m_clrBarText	A cor do BAR de legenda texto.

Comentários

Para criar um BAR de legenda, siga estas etapas:

Construir o CMFCCaptionBar objeto. Normalmente, você adicionaria o BAR de legenda a uma classe de janela de quadro.
telefonar the CMFCCaptionBar::criar método para criar a legenda controle de BAR e anexá-lo para o CMFCCaptionBar objeto.
De telefonarCMFCCaptionBar::SetButton, CMFCCaptionBar::SetText, CMFCCaptionBar::SetIcon, e CMFCCaptionBar::SetBitmap Para conjunto o BAR de legenda elementos.

Quando você conjunto elemento button, você deve atribuir uma ID de comando para o botão.Quando o usuário clica no botão, o BAR de legenda roteia o WM_COMMAND mensagens com essa ID para a janela de quadro pai.

O BAR de legenda também pode trabalhar no modo de BAR de mensagem, que emula a BAR de mensagem que aparece em aplicativos do Microsoft Office 2007.No modo de BAR de mensagem, a BAR de legenda exibe um bitmap, uma mensagem e um botão (que normalmente abre uma caixa de diálogo.) Você pode atribuir uma dica de ferramenta para o bitmap.

Para habilitar o modo de BAR de mensagem, chame CMFCCaptionBar::criar e defina o quarto parâmetro (bIsMessageBarMode) para TRUE.

Exemplo

O exemplo a seguir demonstra como usar diversos métodos no CMFCCaptionBar classe. O exemplo mostra como criar o controle da BAR de legenda, conjunto uma borda 3D da BAR de legenda, defina a distância em pixels, entre a borda dos elementos da BAR de legenda e a borda do controle de BAR de legenda, conjunto o botão da BAR de legenda, conjunto a dica de ferramenta do botão, conjunto o rótulo de texto para a BAR de legenda, conjunto a imagem de bitmap para a BAR de legenda e defina a dica de ferramenta para a imagem na BAR de legenda.Neste trecho de código faz parte o Exemplo do MSOffice2007Demo: Aplicativo do Office MFC.

   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;
}