CMFCCaptionBar Sınıfı

Makale
10/12/2023

CMFCCaptionBar Nesne, üç öğe görüntüleyebilen bir denetim çubuğudur: düğme, metin etiketi ve bit eşlem. Aynı anda her türden yalnızca bir öğe görüntüleyebilir. Her öğeyi denetimin sol veya sağ kenarlarına veya ortaya hizalayabilirsiniz. Başlık çubuğunun üst ve alt kenarlıklarına düz veya 3B stil de uygulayabilirsiniz.

Sözdizimi

class CMFCCaptionBar : public CPane

Üyeler

Genel Yöntemler

Ad	Tanım
CMFCCaptionBar::Create	başlık çubuğu denetimini oluşturur ve nesneye `CMFCCaptionBar` ekler.
CMFCCaptionBar::D oesAllowDynInsertBefore	başlık çubuğu ile üst çerçevesi arasına dinamik olarak başka bir bölme eklenip eklenemeyeceğini gösterir. (Geçersiz Kılmalar CBasePane::D oesAllowDynInsertBefore.)
CMFCCaptionBar::EnableButton	başlık çubuğundaki düğmeyi etkinleştirir veya devre dışı bırakır.
CMFCCaptionBar::GetAlignment	Belirtilen öğenin hizalamasını döndürür.
CMFCCaptionBar::GetBorderSize	başlık çubuğunun kenarlık boyutunu döndürür.
CMFCCaptionBar::GetButtonRect	başlık çubuğundaki düğmenin sınırlayıcı dikdörtgenini alır.
CMFCCaptionBar::GetMargin	başlık çubuk öğelerinin kenarı ile başlık çubuğu denetiminin kenarı arasındaki uzaklığı döndürür.
CMFCCaptionBar::IsMessageBarMode	başlık çubuğunun ileti çubuğu modunda olup olmadığını belirtir.
CMFCCaptionBar::RemoveBitmap	Bit eşlem görüntüsünü başlık çubuğundan kaldırır.
CMFCCaptionBar::RemoveButton	düğmeyi başlık çubuğundan kaldırır.
CMFCCaptionBar::RemoveIcon	simgeyi başlık çubuğundan kaldırır.
CMFCCaptionBar::RemoveText	metin etiketini başlık çubuğundan kaldırır.
CMFCCaptionBar::SetBitmap	başlık çubuğu için bit eşlem görüntüsünü ayarlar.
CMFCCaptionBar::SetBorderSize	başlık çubuğunun kenarlık boyutunu ayarlar.
CMFCCaptionBar::SetButton	başlık çubuğunun düğmesini ayarlar.
CMFCCaptionBar::SetButtonPressed	Düğmeye basılıp basılmayacağını belirtir.
CMFCCaptionBar::SetButtonToolTip	Düğme için araç ipucu ayarlar.
CMFCCaptionBar::SetFlatBorder	başlık çubuğunun kenarlık stilini ayarlar.
CMFCCaptionBar::SetIcon	başlık çubuğunun simgesini ayarlar.
CMFCCaptionBar::SetImageToolTip	başlık çubuğu için görüntü için araç ipucu ayarlar.
CMFCCaptionBar::SetMargin	başlık çubuk öğesinin kenarı ile başlık çubuğu denetiminin kenarı arasındaki uzaklığı ayarlar.
CMFCCaptionBar::SetText	başlık çubuğu için metin etiketini ayarlar.

Korumalı Yöntemler

Ad	Tanım
CMFCCaptionBar::OnDrawBackground	başlık çubuğunun arka planını doldurmak için çerçeve tarafından çağrılır.
CMFCCaptionBar::OnDrawBorder	başlık çubuğunun kenarını çizmek için çerçeve tarafından çağrılır.
CMFCCaptionBar::OnDrawButton	başlık çubuk düğmesini çizmek için çerçeve tarafından çağrılır.
CMFCCaptionBar::OnDrawImage	başlık çubuk görüntüsünü çizmek için çerçeve tarafından çağrılır.
CMFCCaptionBar::OnDrawText	başlık çubuk metnini çizmek için çerçeve tarafından çağrılır.

Veri Üyeleri

Ad	Tanım
CMFCCaptionBar::m_clrBarBackground	başlık çubuğunun arka plan rengi.
CMFCCaptionBar::m_clrBarBorder	başlık çubuğunun kenarlığı rengi.
CMFCCaptionBar::m_clrBarText	başlık çubuk metninin rengi.

Açıklamalar

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

Nesnesini oluşturma CMFCCaptionBar . Genellikle, başlık çubuğunu çerçeve penceresi sınıfına eklersiniz.
başlık çubuk denetimini oluşturmak ve nesneye eklemek için CMFCCaptionBar::Create yöntemini çağırınCMFCCaptionBar.
başlık çubuk öğelerini ayarlamak için CMFCCaptionBar::SetButton, CMFCCaptionBar::SetText , CMFCCaptionBar::SetIcon ve CMFCCaptionBar::SetBitmap öğelerini çağırın.

Düğme öğesini ayarladığınızda, düğmeye bir komut kimliği atamanız gerekir. Kullanıcı düğmeye tıkladığında, başlık çubuğu bu kimliği içeren WM_COMMAND iletilerini üst çerçeve penceresine yönlendirir.

başlık çubuğu, Microsoft Office 2007 uygulamalarında görüntülenen ileti çubuğuna öykünen ileti çubuğu modunda da çalışabilir. İleti çubuğu modunda, başlık çubuğunda bit eşlem, ileti ve düğme (genellikle bir iletişim kutusu açılır) görüntülenir. Bit eşlem için bir araç ipucu atayabilirsiniz.

İleti çubuğu modunu etkinleştirmek için CMFCCaptionBar::Create öğesini çağırın ve dördüncü parametreyi (bIsMessageBarMode) TRUE olarak ayarlayın.

Örnek

Aşağıdaki örnekte, sınıftaki çeşitli yöntemlerin nasıl kullanılacağı gösterilmektedir CMFCCaptionBar . Örnekte, başlık çubuk denetiminin nasıl oluşturulacağı, başlık çubuğunun 3B kenarlığı, başlık çubuğu öğelerinin kenarı ile başlık çubuğu denetiminin kenarı arasındaki uzaklığı piksel cinsinden ayarlama, başlık çubuğu için düğmeyi ayarlama, düğme için araç ipucu ayarlama, başlık için metin etiketini ayarlama gösterilmektedir çubuğuna gidin, başlık çubuğu için bit eşlem görüntüsünü ayarlayın ve başlık çubuğundaki görüntünün araç ipucuna ayarlayın. Bu kod parçacığı MS Office 2007 Tanıtım örneğinin bir parçasıdır.

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

Devralma Hiyerarşisi

Gereksinimler

Üst bilgi: afx başlık bar.h

CMFCCaptionBar::Create

başlık çubuğu denetimini oluşturur ve nesneye CMFCCaptionBar ekler.

BOOL Create(
    DWORD dwStyle,
    CWnd* pParentWnd,
    UINT uID,
    int nHeight=-1,
    BOOL bIsMessageBarMode=FALSE);

Parametreler

Dwstyle
başlık çubuk stillerinin mantıksal OR bileşimi.

pParentWnd
başlık çubuğu denetiminin üst penceresi.

Uıd
başlık çubuğu denetiminin kimliği.

Nheight
başlık çubuğu denetiminin piksel cinsinden yüksekliği. -1 ise, yükseklik simgenin yüksekliğine, başlık çubuk denetiminin görüntülediği metne ve düğmeye göre hesaplanır.

bIsMessageBarMode
başlık çubuğu ileti çubuğu modundaysa TRUE; FALSE aksi takdirde.

İade Değeri

başlık çubuğu denetimi başarıyla oluşturulursa TRUE; FALSE aksi takdirde.

Açıklamalar

İki adımda bir CMFCCaptionBar nesne oluşturursunuz. Önce oluşturucuyu çağırırsınız ve ardından Windows denetimini oluşturan ve nesnesine CMFCCaptionBar ekleyen yöntemini çağırırsınızCreate.

CMFCCaptionBar::D oesAllowDynInsertBefore

başlık çubuğu ile üst çerçevesi arasına dinamik olarak başka bir bölme eklenip eklenemeyeceğini gösterir.

virtual BOOL DoesAllowDynInsertBefore() const;

İade Değeri

Geçersiz kılınmadığı sürece YANLIŞ döndürür.

Açıklamalar

CMFCCaptionBar::EnableButton

başlık çubuğundaki düğmeyi etkinleştirir veya devre dışı bırakır.

void EnableButton(BOOL bEnable=TRUE);

Parametreler

bEnable
[in] Düğmeyi etkinleştirmek için TRUE, düğmeyi devre dışı bırakmak için YANLIŞ.

CMFCCaptionBar::GetAlignment

Belirtilen öğenin hizalamasını döndürür.

BarElementAlignment GetAlignment(BarElement elem);

Parametreler

Elem
[in] Hizalamanın alındığı başlık çubuk öğesi.

İade Değeri

Düğme, bit eşlem, metin veya simge gibi bir öğenin hizalaması.

Açıklamalar

öğesinin hizalaması aşağıdaki değerlerden biri olabilir:

ALIGN_INVALID
ALIGN_LEFT
ALIGN_RIGHT
ALIGN_CENTER

CMFCCaptionBar::GetBorderSize

başlık çubuğunun kenarlık boyutunu döndürür.

int GetBorderSize() const;

İade Değeri

Kenarlık boyutu piksel cinsindendir.

CMFCCaptionBar::GetButtonRect

başlık çubuğundaki düğmenin sınırlayıcı dikdörtgenini alır.

CRect GetButtonRect() const;

İade Değeri

CRect başlık çubuğundaki düğmenin sınırlayıcı dikdörtgeninin koordinatlarını içeren nesne.

CMFCCaptionBar::GetMargin

başlık çubuk öğelerinin kenarı ile başlık çubuğu denetiminin kenarı arasındaki uzaklığı döndürür.

int GetMargin() const;

İade Değeri

başlık çubuk öğelerinin kenarıyla başlık çubuk denetiminin kenarı arasındaki uzaklık piksel cinsinden.

CMFCCaptionBar::IsMessageBarMode

başlık çubuğunun ileti çubuğu modunda olup olmadığını belirtir.

BOOL IsMessageBarMode() const;

İade Değeri

başlık çubuğu ileti çubuğu modundaysa TRUE; FALSE aksi takdirde.

Açıklamalar

İleti çubuğu modunda, başlık çubuğunda araç ipucu, ileti metni ve düğme içeren bir görüntü görüntülenir.

CMFCCaptionBar::m_clrBarBackground

başlık çubuğunun arka plan rengi.

COLORREF m_clrBarBackground

CMFCCaptionBar::m_clrBarBorder

başlık çubuğunun kenarlığı rengi.

COLORREF m_clrBarBorder

CMFCCaptionBar::m_clrBarText

başlık çubuk metninin rengi.

COLORREF m_clrBarText

CMFCCaptionBar::OnDrawBackground

başlık çubuğunun arka planını doldurmak için çerçeve tarafından çağrılır.

virtual void OnDrawBackground(
    CDC* pDC,
    CRect rect);

Parametreler

Pdc
[in] başlık çubuğunun cihaz bağlamını işaret eden bir işaretçi.

Rect
[in] Doldurulacak sınırlayıcı dikdörtgen.

Açıklamalar

OnDrawBackground yöntemi, başlık çubuğunun arka planı doldurulmak üzere olduğunda çağrılır. Varsayılan uygulama, CMFCCaptionBar::m_clrBarBackground rengini kullanarak arka planı doldurur.

başlık çubuğunun görünümünü özelleştirmek için türetilmiş bir CMFCCaptionBar sınıfta bu yöntemi geçersiz kılın.

CMFCCaptionBar::OnDrawBorder

başlık çubuğunun kenarını çizmek için çerçeve tarafından çağrılır.

virtual void OnDrawBorder(
    CDC* pDC,
    CRect rect);

Parametreler

Pdc
[in] Kenarlıkları görüntülemek için kullanılan cihaz bağlamı.

Rect
[in] Sınırlayıcı dikdörtgen.

Açıklamalar

Varsayılan olarak, kenarlıklar düz stile sahiptir.

başlık çubuğunun kenarlıklarının görünümünü özelleştirmek için türetilmiş bir CMFCCaptionBar sınıfta bu yöntemi geçersiz kılın.

CMFCCaptionBar::OnDrawButton

başlık çubuk düğmesini çizmek için çerçeve tarafından çağrılır.

virtual void OnDrawButton(
    CDC* pDC,
    CRect rect,
    const CString& strButton,
    BOOL bEnabled);

Parametreler

Pdc
[in] Düğmeyi görüntülemek için kullanılan bir cihaz bağlamı işaretçisi.

Rect
[in] Düğmenin sınırlayıcı dikdörtgeni.

strButton
[in] Düğmenin metin etiketi.

bEnabled
[in] Düğme etkinse TRUE; FALSE aksi takdirde.

Açıklamalar

başlık çubuğunun düğmesinin görünümünü özelleştirmek için türetilmiş bir CMFCCaptionBar sınıfta bu yöntemi geçersiz kılın.

CMFCCaptionBar::OnDrawImage

başlık çubuk görüntüsünü çizmek için çerçeve tarafından çağrılır.

virtual void OnDrawImage(
    CDC* pDC,
    CRect rect);

Parametreler

Pdc
[in] Görüntüyü görüntülemek için kullanılan bir cihaz bağlamı işaretçisi.

Rect
[in] Görüntünün sınırlayıcı dikdörtgenini belirtir.

Açıklamalar

Görüntü görünümünü özelleştirmek için türetilmiş bir CMFCCaptionBar sınıfta bu yöntemi geçersiz kılın.

CMFCCaptionBar::OnDrawText

başlık çubuk metnini çizmek için çerçeve tarafından çağrılır.

virtual void OnDrawText(
    CDC* pDC,
    CRect rect,
    const CString& strText);

Parametreler

Pdc
[in] Düğmeyi görüntülemek için kullanılan bir cihaz bağlamı işaretçisi.

Rect
[in] Metnin sınırlayıcı dikdörtgeni.

strText
[in] Görüntülenecek metin dizesi.

Açıklamalar

Varsayılan uygulama, ve CMFCCaptionBar::m_clrBarText rengini kullanarak CDC::DrawText metni görüntüler.

başlık çubuğunun metninin görünümünü özelleştirmek için türetilmiş bir CMFCCaptionBar sınıfta bu yöntemi geçersiz kılın.

CMFCCaptionBar::RemoveBitmap

Bit eşlem görüntüsünü başlık çubuğundan kaldırır.

void RemoveBitmap();

CMFCCaptionBar::RemoveButton

düğmeyi başlık çubuğundan kaldırır.

void RemoveButton();

Açıklamalar

başlık çubuk öğelerinin düzeni otomatik olarak ayarlanır.

CMFCCaptionBar::RemoveIcon

simgeyi başlık çubuğundan kaldırır.

void RemoveIcon();

CMFCCaptionBar::RemoveText

metin etiketini başlık çubuğundan kaldırır.

void RemoveText();

CMFCCaptionBar::SetBitmap

başlık çubuğu için bit eşlem görüntüsünü ayarlar.

void SetBitmap(
    HBITMAP hBitmap,
    COLORREF clrTransparent,
    BOOL bStretch=FALSE,
    BarElementAlignment bmpAlignment=ALIGN_RIGHT);

void SetBitmap(
    UINT uiBmpResID,
    COLORREF clrTransparent,
    BOOL bStretch=FALSE,
    BarElementAlignment bmpAlignment=ALIGN_RIGHT);

Parametreler

Hbıtmap
[in] Ayarlanacağı bit eşlem tutamacı.

clrTransparent
[in] Bit eşlem saydam rengini belirten RGB değeri.

bStretch
[in] TRUE ise, bit eşlem görüntü sınırlayıcı dikdörtgene sığmazsa esnetilir. Aksi takdirde bit eşlem uzatılmaz.

bmpAlignment
[in] Bit eşlem hizalaması.

Açıklamalar

başlık çubuğunda bit eşlem ayarlamak için bu yöntemi kullanın.

Önceki bit eşlem otomatik olarak yok edilir. CMFCCaptionBar::SetIcon yöntemini çağırdığınız için başlık çubuğunda bir simge görüntüleniyorsa, CMFCCaptionBar::RemoveIcon çağrısı yaparak simgeyi kaldırmadığınız sürece bit eşlem görüntülenmez.

Bit eşlem, bmpAlignment parametresi tarafından belirtilen şekilde hizalanır. Bu parametre aşağıdaki BarElementAlignment değerlerden biri olabilir:

ALIGN_INVALID
ALIGN_LEFT
ALIGN_RIGHT
ALIGN_CENTER

CMFCCaptionBar::SetBorderSize

başlık çubuğunun kenarlık boyutunu ayarlar.

void SetBorderSize(int nSize);

Parametreler

nSize
[in] başlık çubuk kenarlarının piksel cinsinden yeni boyutu.

CMFCCaptionBar::SetButton

başlık çubuğunun düğmesini ayarlar.

void SetButton(
    LPCTSTR lpszLabel,
    UINT uiCmdUI,
    BarElementAlignment btnAlignmnet=ALIGN_LEFT,
    BOOL bHasDropDownArrow=TRUE);

Parametreler

lpszLabel
Düğmenin komut etiketi.

uiCmdUI
Düğmenin komut kimliği.

btnAlignmnet
Düğmenin hizalaması.

bHasDropDownArrow
Düğme bir açılan ok görüntülüyorsa DOĞRU, aksi takdirde YANLIŞ.

CMFCCaptionBar::SetButtonPressed

Düğmeye basılıp basılmayacağını belirtir.

void SetButtonPressed(BOOL bPresed=TRUE);

Parametreler

bPresed
Düğme basılı durumda kalırsa TRUE, aksi takdirde YANLIŞ.

CMFCCaptionBar::SetButtonToolTip

Düğme için araç ipucu ayarlar.

void SetButtonToolTip(
    LPCTSTR lpszToolTip,
    LPCTSTR lpszDescription=NULL);

Parametreler

lpszToolTip
[in] Araç ipucu başlık.

lpszDescription
[in] Araç ipucu açıklaması.

CMFCCaptionBar::SetFlatBorder

başlık çubuğunun kenarlık stilini ayarlar.

void SetFlatBorder(BOOL bFlat=TRUE);

Parametreler

bFlat
[in] başlık çubuğunun kenarlık düzse TRUE. Kenarlık 3B ise YANLIŞ.

CMFCCaptionBar::SetIcon

başlık çubuğunun simgesini ayarlar.

void SetIcon(
    HICON hIcon,
    BarElementAlignment iconAlignment=ALIGN_RIGHT);

Parametreler

Hıcon
[in] Ayarlanacağı simgenin tutamacı.

iconAlignment
[in] Simgenin hizalaması.

Açıklamalar

Resim yazısı çubukları simgeleri veya bit eşlemleri görüntüleyebilir. Bit eşlem görüntülemeyi öğrenmek için bkz . CMFCCaptionBar::SetBitmap . Hem simge hem de bit eşlem ayarlarsanız, simge her zaman görüntülenir. başlık çubuğundan bir simgeyi kaldırmak için CMFCCaptionBar::RemoveIcon çağrısı yapın.

Simge iconAlignment parametresine göre hizalanır. Aşağıdaki BarElementAlignment değerlerden biri olabilir:

ALIGN_INVALID
ALIGN_LEFT
ALIGN_RIGHT
ALIGN_CENTER

CMFCCaptionBar::SetImageToolTip

başlık çubuğundaki görüntü için araç ipucu ayarlar.

void SetImageToolTip(
    LPCTSTR lpszToolTip,
    LPCTSTR lpszDescription=NULL);

Parametreler

lpszToolTip
[in] Araç ipucu metni.

lpszDescription
[in] Araç ipucu açıklaması.

CMFCCaptionBar::SetMargin

başlık çubuk öğesinin kenarı ile başlık çubuğu denetiminin kenarı arasındaki uzaklığı ayarlar.

void SetMargin(int nMargin);

Parametreler

nMargin
[in] başlık çubuk öğelerinin kenarıyla başlık çubuk denetiminin kenarı arasındaki uzaklık piksel cinsinden.

CMFCCaptionBar::SetText

başlık çubuğu için metin etiketini ayarlar.

void SetText(
    const CString& strText,
    BarElementAlignment textAlignment=ALIGN_RIGHT);

Parametreler

strText
[in] Ayarlanacağı metin dizesi.

Textalignment
[in] Metin hizalaması.

Açıklamalar

Metin etiketi textAlignment parametresi tarafından belirtilen şekilde hizalanır. Aşağıdaki BarElementAlignment değerlerden biri olabilir:

ALIGN_INVALID
ALIGN_LEFT
ALIGN_RIGHT
ALIGN_CENTER

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar

Aracılığıyla paylaş

CMFCCaptionBar Sınıfı

Sözdizimi

Üyeler

Genel Yöntemler

Korumalı Yöntemler

Veri Üyeleri

Açıklamalar

Örnek

Devralma Hiyerarşisi

Gereksinimler

CMFCCaptionBar::Create

Parametreler

İade Değeri

Açıklamalar

CMFCCaptionBar::D oesAllowDynInsertBefore

İade Değeri

Açıklamalar

CMFCCaptionBar::EnableButton

Parametreler

CMFCCaptionBar::GetAlignment

Parametreler

İade Değeri

Açıklamalar

CMFCCaptionBar::GetBorderSize

İade Değeri

CMFCCaptionBar::GetButtonRect

İade Değeri

CMFCCaptionBar::GetMargin

İade Değeri

CMFCCaptionBar::IsMessageBarMode

İade Değeri

Açıklamalar

CMFCCaptionBar::m_clrBarBackground

CMFCCaptionBar::m_clrBarBorder

CMFCCaptionBar::m_clrBarText

CMFCCaptionBar::OnDrawBackground

Parametreler

Açıklamalar

CMFCCaptionBar::OnDrawBorder

Parametreler

Açıklamalar

CMFCCaptionBar::OnDrawButton

Parametreler

Açıklamalar

CMFCCaptionBar::OnDrawImage

Parametreler

Açıklamalar

CMFCCaptionBar::OnDrawText

Parametreler

Açıklamalar

CMFCCaptionBar::RemoveBitmap

CMFCCaptionBar::RemoveButton

Açıklamalar

CMFCCaptionBar::RemoveIcon

CMFCCaptionBar::RemoveText

CMFCCaptionBar::SetBitmap

Parametreler

Açıklamalar

CMFCCaptionBar::SetBorderSize

Parametreler

CMFCCaptionBar::SetButton

Parametreler

CMFCCaptionBar::SetButtonPressed

Parametreler

CMFCCaptionBar::SetButtonToolTip

Parametreler

CMFCCaptionBar::SetFlatBorder

Parametreler

CMFCCaptionBar::SetIcon

Parametreler

Açıklamalar

CMFCCaptionBar::SetImageToolTip

Parametreler

CMFCCaptionBar::SetMargin

Parametreler

CMFCCaptionBar::SetText

Parametreler

Açıklamalar

Ayrıca bkz.