CTabbedPane Sınıfı

Ayrılabilir sekmeler içeren bir bölmenin işlevselliğini uygular.

veya daha ayrıntılı bilgi için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

Sözdizimi

class CTabbedPane : public CBaseTabbedPane

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Veri Üyeleri

Açıklamalar

Çerçeve, kullanıcı ikinci bölmenin resim yazısına işaret ederek bir bölmeyi diğerine eklediğinde bu sınıfın bir örneğini otomatik olarak oluşturur. Çerçeve tarafından oluşturulan tüm sekmeli bölmelerin kimliği -1 olur.

Outlook stili sekmeler yerine normal sekmeler belirtmek için AFX_CBRS_REGULAR_TABS stilini CDockablePane::CreateEx yöntemine geçirin.

Ayrılabilir sekmeler içeren bir sekmeli bölme oluşturursanız, bölme çerçeve tarafından otomatik olarak yok edilebilir, bu nedenle işaretçiyi depolamamalısınız. Sekmeli bölmeye bir işaretçi almak için yöntemini çağırın CBasePane::GetParentTabbedPane .

Örnekler

Bu örnekte bir CTabbedPane nesnesi oluşturacağız. Ardından, ek sekmeler eklemek için CBaseTabbedPane::AddTab kullanacağız.

CTabbedPane* pTabbededBar = new CTabbedPane (TRUE);

if (!pTabbededBar->Create (_T(""),
    this,
    CRect (0,
    0,
    200,
    200),
    TRUE,
    (UINT) -1,
    WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS |
    WS_CLIPCHILDREN | CBRS_LEFT |
    CBRS_FLOAT_MULTI))
{
    TRACE0("Failed to create Solution Explorer bar\n");

    return FALSE;      // fail to create
}

pTabbededBar->AddTab (&m_wndClassView);
pTabbededBar->AddTab (&m_wndResourceView);

pTabbededBar->AddTab (&m_wndFileView);
pTabbededBar->EnableDocking(CBRS_ALIGN_ANY);

DockPane(pTabbededBar);

Sekmeli denetim çubuğu nesnesi oluşturmanın başka bir yolu da CDockablePane::AttachToTabWnd kullanmaktır. yöntemi, AttachToTabWnd CDockablePane::SetTabbedPaneRTC tarafından ayarlanan çalışma zamanı sınıf bilgilerini kullanarak dinamik olarak bir sekmeli bölme nesnesi oluşturur.

Bu örnekte, dinamik olarak bir sekmeli bölme oluşturacak, iki sekme ekleyip ikinci sekmeyi ayrılamaz hale getireceğiz.

DockPane(&m_wndClassView);

CTabbedPane* pTabbedBar = NULL;
m_wndResourceView.AttachToTabWnd (&m_wndClassView,
    DM_SHOW,
    TRUE,
    (CDockablePane**) &pTabbedBar);

m_wndFileView.AttachToTabWnd (pTabbedBar,
    DM_SHOW,
    TRUE,
    (CDockablePane**) &pTabbedBar);

pTabbedBar->GetUnderlyingWindow ()->EnableTabDetach (1,
    FALSE);

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

CBaseTabbedPane

CTabbedPane

Gereksinimler

Üst bilgi: afxTabbedPane.h

CTabbedPane::D etachPane

virtual BOOL DetachPane(
    CWnd* pBar,
    BOOL bHide = FALSE);

Parametreler

[in] pBar

[in] bHide

Dönüş Değeri

Açıklamalar

CTabbedPane::EnableTabAutoColor

Sekmelerin otomatik renklendirmesini etkinleştirir veya devre dışı bırakır.

static void EnableTabAutoColor(BOOL bEnable = TRUE);

Parametreler

bEnable
[in] Sekmelerin otomatik renklendirmesini etkinleştirmek için TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Uygulamadaki tüm sekmeli bölmelerde sekmelerin otomatik renklendirmesini etkinleştirmek veya devre dışı bırakmak için bu statik yöntemi kullanın. Bu özellik etkinleştirildiğinde, her sekme kendi rengiyle doldurulur. CMFCBaseTabCtrl::GetAutoColors yöntemini çağırarak sekmeleri renklendirmek için kullanılan renklerin listesini bulabilirsiniz.

CTabbedPane::SetTabAutoColors çağrısı yaparak sekmeler için kullanılacak renklerin listesini belirtebilirsiniz.

Varsayılan olarak, bu seçenek devre dışıdır.

CTabbedPane::FloatTab

virtual BOOL FloatTab(
    CWnd* pBar,
    int nTabID,
    AFX_DOCK_METHOD dockMethod,
    BOOL bHide = FALSE);

Parametreler

[in] pBar
[in] nTabID
[in] dockMethod
[in] bHide

Dönüş Değeri

Açıklamalar

CTabbedPane::GetTabArea

Sekmeli penceredeki sekme alanının boyutunu ve konumunu döndürür.

virtual void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Parametreler

rectTabAreaTop
[out] Üst sekme alanının boyutunu ve konumunu ekran koordinatlarında içerir.

rectTabAreaBottom
[out] Alt sekme alanının boyutunu ve konumunu ekran koordinatlarında içerir.

Açıklamalar

Çerçeve, kullanıcının sürüklediği bir bölmenin nasıl yerleştirileceğini belirlemek için bu yöntemi çağırır. Kullanıcı bir bölmeyi hedef bölmenin sekme alanının üzerine sürüklediğinde, çerçeve bunu hedef bölmenin yeni bir sekmesi olarak eklemeye çalışır. Aksi takdirde, bölmeyi hedef bölmenin yanına yerleştirmeye çalışır ve bu, iki bölmeyi ayıran bir bölme ayırıcı ile yeni bir bölme kapsayıcısı oluşturmayı içerir.

Bu davranışı değiştirmek için türetilmiş bir CTabbedPanesınıfta bu yöntemi geçersiz kılın.

CTabbedPane::GetTabWnd

CMFCTabCtrl* GetTabWnd() const;

Dönüş Değeri

Açıklamalar

CTabbedPane::HasAutoHideMode

virtual BOOL HasAutoHideMode() const;

Dönüş Değeri

Açıklamalar

CTabbedPane::IsTabLocationBottom

Sekmelerin pencerenin alt kısmında bulunup bulunmadığını belirler.

virtual BOOL IsTabLocationBottom() const;

Dönüş Değeri

Sekme alanı sekmeli pencerenin en altında yer alıyorsa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

CTabbedPane::m_bTabsAlwaysTop

Uygulamadaki sekmeler için varsayılan konum.

AFX_IMPORT_DATA static BOOL m_bTabsAlwaysTop;

Açıklamalar

Uygulamadaki tüm sekmelerin sekmeli bölmenin en üstünde görüntülenmesini zorlamak için bu statik üyeyi TRUE olarak ayarlayın.

Sekmeli bölme oluşturulmadan önce bu değeri ayarlamanız gerekir.

Varsayılan değer YANLIŞ'tır.

CTabbedPane::m_pTabWndRTC

Özel CMFCTabCtrltüretilmiş bir nesne için çalışma zamanı sınıf bilgileri.

AFX_IMPORT_DATA static CRuntimeClass* m_pTabWndRTC;

Açıklamalar

Sekmeli bölme içinde özel bir sekmeli pencere kullanıyorsanız, bu statik üye değişkenini türetilmiş bir CMFCTabCtrlnesnenin çalışma zamanı sınıf bilgilerine bir işaretçi olarak ayarlayın.

CTabbedPane::ResetTabs

Tüm sekmeli bölmeleri varsayılan duruma sıfırlar.

static void ResetTabs();

Açıklamalar

Tüm sekmeli bölmeleri varsayılan durumlarına geri döndürmek için bu yöntemi çağırın. Çağrıldığında, bu yöntem tüm sekmeli bölmelerin kenarlık boyutlarını ve otomatik renk durumunu sıfırlar.

CTabbedPane::SetTabAutoColors

Otomatik renk özelliği etkinleştirildiğinde kullanılan özel renklerin listesini ayarlar.

static void SetTabAutoColors(const CArray<COLORREF, COLORREF>& arColors);

Parametreler

arColors
[in] Ayarlanacağı renk dizisini içerir.

Açıklamalar

Otomatik renk özelliği etkinleştirildiğinde kullanılan renk listesini özelleştirmek için bu yöntemi kullanın. Bu statik bir işlevdir ve uygulamanızdaki tüm sekmeli bölmeleri etkiler.

Otomatik renk özelliğini etkinleştirmek veya devre dışı bırakmak için CTabbedPane::EnableTabAutoColor kullanın.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CDockablePane Sınıfı
CBaseTabbedPane Sınıfı
CMFCOutlookBar Sınıfı