CMFCCaptionBar sınıfı

Makale
02/26/2013

A CMFCCaptionBar üç öğe görüntüleyen bir denetim çubuğu nesnesidir: bir düğme ve bir metin etiketi bir bit eşlem.Bir anda her türünün bir öğesi yalnızca görüntüleyebilir.Her öğe denetiminin sol veya sağ kenarına veya merkezine hizalayabilirsiniz.Ayrıca başlık çubuğunun üst ve alt kenarlık düz veya 3B stil uygulayabilirsiniz.

class CMFCCaptionBar : public CPane

Üyeler

Ortak Yöntemler

Ad	Tanımlama
CMFCCaptionBar::Create	Başlık çubuğu denetimi oluşturur ve ekler CMFCCaptionBar nesne.
CMFCCaptionBar::DoesAllowDynInsertBefore	Başka bir bölme dinamik olarak başlık çubuğu ve ana çerçevesini arasında eklenebilir olup olmadığını gösterir.(Geçersiz kılar CBasePane::DoesAllowDynInsertBefore.)
CMFCCaptionBar::EnableButton	Başlık çubuğu düğmesini devre dışı bırakır ya da sağlar.
CMFCCaptionBar::GetAlignment	Belirtilen öğenin hizalamasını döndürür.
CMFCCaptionBar::GetBorderSize	Başlık çubuğunda Kenarlık boyutunu döndürür.
CMFCCaptionBar::GetButtonRect	Başlık çubuğu düğmesini çevreleyen dikdörtgenin alır.
CMFCCaptionBar::GetMargin	Başlık çubuğu öğelerinin kenar başlık çubuğu denetimi kenarı arasındaki uzaklığı döndürür.
CMFCCaptionBar::IsMessageBarMode	Başlık çubuğunu ileti çubuğu modunda olup olmadığını belirtir.
CMFCCaptionBar::RemoveBitmap	Bit eşlem resmi başlık çubuğundan kaldırır.
CMFCCaptionBar::RemoveButton	Başlık çubuğundan düğmesini kaldırır.
CMFCCaptionBar::RemoveIcon	Simgenin başlık çubuğundan kaldırır.
CMFCCaptionBar::RemoveText	Metin etiketi başlık çubuğundan kaldırır.
CMFCCaptionBar::SetBitmap	Başlık çubuğu için bit eşlem resmi olarak ayarlar.
CMFCCaptionBar::SetBorderSize	Başlık çubuğunda Kenarlık boyutunu ayarlar.
CMFCCaptionBar::SetButton	Başlık çubuğu düğme ayarlar.
CMFCCaptionBar::SetButtonPressed	Düğmeyi basılı kalır olup olmadığını belirtir.
CMFCCaptionBar::SetButtonToolTip	Ayarlar düğmesi için araç ipucu.
CMFCCaptionBar::SetFlatBorder	Başlık çubuğunda kenarlık stilini ayarlar.
CMFCCaptionBar::SetIcon	Başlık çubuğu simgesi olarak ayarlar.
CMFCCaptionBar::SetImageToolTip	Başlık çubuğu için görüntünün araç ipucu olarak ayarlar.
CMFCCaptionBar::SetMargin	Başlık çubuğu öğesi kenarına ve başlık çubuğu denetimi kenarı arasındaki uzaklığı belirler.
CMFCCaptionBar::SetText	Başlık çubuğu için metin etiketi belirler.

Korumalı yöntemleri

Ad	Tanımlama
CMFCCaptionBar::OnDrawBackground	Başlık çubuğu arka planını doldurmak için çerçeve tarafından çağrıldı.
CMFCCaptionBar::OnDrawBorder	Başlık çubuğunda Kenarlık Çiz çerçevesi tarafından çağrıldı.
CMFCCaptionBar::OnDrawButton	Başlık çubuğu düğmesi çizmek için çerçeve tarafından çağrıldı.
CMFCCaptionBar::OnDrawImage	Başlık çubuğu resim çizmek için çerçeve tarafından çağrıldı.
CMFCCaptionBar::OnDrawText	Başlık çubuğu metnini çizmek için çerçeve tarafından çağrıldı.

Veri üyeleri

Ad	Tanımlama
CMFCCaptionBar::m_clrBarBackground	Başlık çubuğu arka plan rengi.
CMFCCaptionBar::m_clrBarBorder	Kenarlık başlık çubuğunun rengi.
CMFCCaptionBar::m_clrBarText	Başlık çubuğu metnini rengi.

Notlar

Başlık çubuğu oluşturmak için aşağıdaki adımları izleyin:

Yapısı CMFCCaptionBar nesne.Genellikle, bir kare pencere sınıfı için başlık çubuğunu eklediğiniz.
Call CMFCCaptionBar::Create yöntemi ekleyebilir ve başlık çubuğu denetimi oluşturmak için CMFCCaptionBar nesne.
Call CMFCCaptionBar::SetButton, CMFCCaptionBar::SetText, CMFCCaptionBar::SetIcon, ve CMFCCaptionBar::SetBitmap başlık çubuğu öğeleri ayarlamak için.

Düğme öğesi ayarlarken, düğmenin komut kimliği atamanız gerekir.Başlık çubuğu yollar düğmesini tıkladığında kullanıcı WM_COMMAND üst çerçeve penceresi için bu Kimliğe sahip iletileri.

Başlık çubuğu Microsoft Office 2007 uygulamalarında görüntülenen ileti Çubuğu'nu öykünür ileti çubuğu modunda da çalışabilir.İleti Çubuğu modunda, bir bit eşlem, ileti ve (genellikle bir iletişim kutusu açar.) bir düğmeye başlık çubuğunu görüntüler Bit eşlem için araç ipucu atayabilirsiniz.

İleti Çubuğu modunu etkinleştirmek için arama CMFCCaptionBar::Create ve dördüncü parametre (bIsMessageBarMode) TRUE.

Örnek

Aşağıdaki örnekte çeşitli yöntemlerini kullanmak gösterilmiştir CMFCCaptionBar sınıf.Örnek başlık çubuğu denetimi oluşturun, 3B kenarlık başlık çubuğunun ayarla, başlık çubuğu denetiminin kenarını başlık çubuğu öğelerini kenarı arasındaki piksel uzaklık ayarla, başlık çubuğu düğmesi ayarlamak, Ayarla düğmesi için araç ipucu, başlık çubuğu metin etiketini ayarlama, başlık çubuğu için bit eşlem görüntüsünü ayarlamak için nasıl gösterirve görüntünün araç ipucu başlık çubuğunda ayarlayın.Bu kod parçacığını parçası olan ms Office 2007 Demo örnek.

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