Aracılığıyla paylaş

CDockablePane Sınıf

  • Makale

Dock sitesine yerleştirilebilen veya sekmeli bölmeye dahil edilebilen bir bölme uygular.

Sözdizimi

class CDockablePane : public CPane

Üyeler

Ortak Oluşturucular

Veri Akışı Adı Açıklama
CDockablePane::CDockablePane Bir CDockablePane nesneyi oluşturur ve başlatır.

Genel Yöntemler

Veri Akışı Adı Açıklama
CDockablePane::AttachToTabWnd Bir bölmeyi başka bir bölmeye ekler. Bu, sekmeli bir bölme oluşturur.
CDockablePane::CalcFixedLayout Bölme dikdörtgeninin boyutunu döndürür.
CDockablePane::CanAcceptMiniFrame Belirtilen mini çerçevenin bölmeye yerleştirilip yerleştirilemeyeceğini belirler.
CDockablePane::CanAcceptPane Geçerli bölmeye başka bir bölmenin yerleştirilip yerleştirilemeyeceğini belirler.
CDockablePane::CanAutoHide Bölmenin otomatik gizleme modunu destekleyip desteklemediğini belirler. (Geçersiz Kılmalar CBasePane::CanAutoHide.)
CDockablePane::CanBeAttached Geçerli bölmenin başka bir bölmeye yerleştirilip yerleştirilemeyeceğini belirler.
CDockablePane::ConvertToTabbedDocument Bir veya daha fazla yerleşik bölmeyi MDI sekmeli belgelere dönüştürür.
CDockablePane::CopyState Yerleştirilebilir bölmenin durumunu kopyalar.
CDockablePane::Create Windows denetimini oluşturur ve nesneye CDockablePane ekler.
CDockablePane::CreateDefaultPaneDivider Bir çerçeve penceresine yerleştirildiğinden bölme için varsayılan ayırıcı oluşturur.
CDockablePane::CreateEx Windows denetimini oluşturur ve nesneye CDockablePane ekler.
CDockablePane::CreateTabbedPane Geçerli bölmeden sekmeli bir bölme oluşturur.
CDockablePane::DockPaneContainer Kapsayıcıyı bölmeye sabitler.
CDockablePane::DockPaneStandard Ana hat (standart) yerleştirmeyi kullanarak bir bölmeyi sabitler.
CDockablePane::DockToFrameWindow Dahili olarak kullanılır. Bölmeyi takmak için veya CDockablePane::DockToWindowkullanınCPane::DockPane.
CDockablePane::DockToRecentPos Bir bölmeyi depolanmış en son yerleştirme konumuna yerleştirir.
CDockablePane::DockToWindow Bir yerleştirme bölmesini başka bir yerleştirme bölmesine sabitler.
CDockablePane::EnableAutohideAll Kapsayıcıdaki diğer bölmelerle birlikte bu bölme için otomatik gizleme modunu etkinleştirir veya devre dışı bırakır.
CDockablePane::EnableGripper Resim yazısını (kavrama) gösterir veya gizler.
CDockablePane::GetAHRestoredRect Otomatik gizleme modunda görünür durumdayken bölmenin konumunu belirtir.
CDockablePane::GetAHSlideMode Bölme için slayt modunu otomatik gizlemeyi alır.
CDockablePane::GetAutoHideButton Dahili olarak kullanılır.
CDockablePane::GetAutoHideToolBar Dahili olarak kullanılır.
CDockablePane::GetCaptionHeight Geçerli resim yazısının yüksekliğini döndürür.
CDockablePane::GetDefaultPaneDivider Bölmenin kapsayıcısı için varsayılan bölme ayırıcısını döndürür.
CDockablePane::GetDockingStatus Sağlanan işaretçi konumuna göre bölmenin yerleştirilebilme becerisini belirler.
CDockablePane::GetDragSensitivity Yerleştirme bölmesinin sürükleme duyarlılığını döndürür.
CDockablePane::GetLastPercentInPaneContainer Bir bölmenin kapsayıcı içinde kaplayan alan yüzdesini alır.
CDockablePane::GetTabArea Bölmenin sekme alanını alır.
CDockablePane::GetTabbedPaneRTC Başka bir bölme geçerli bölmeye yerleştirildiğinde oluşturulan sekmeli pencereyle ilgili çalışma zamanı sınıf bilgilerini döndürür.
CDockablePane::HasAutoHideMode Bir yerleştirme bölmesinin otomatik gizleme moduna geçirilip geçirilemeyeceğini belirtir.
CDockablePane::HitTest Kullanıcının fareyi tıklattığı bölmedeki belirli konumu belirtir.
CDockablePane::IsAccessibilityCompatible Dahili olarak kullanılır.
CDockablePane::IsAutohideAllEnabled Kapsayıcıdaki yerleştirme bölmesinin ve diğer tüm bölmelerin otomatik gizleme moduna yerleştirilip yerleştirilemeyeceğini gösterir.
CDockablePane::IsAutoHideMode Bir bölmenin otomatik gizleme modunda olup olmadığını belirler.
CDockablePane::IsChangeState Dahili olarak kullanılır.
CDockablePane::IsDocked Geçerli bölmenin yerleşik olup olmadığını belirler.
CDockablePane::IsHideInAutoHideMode çağrısıyla ShowPanegösteriliyorsa (veya gizleniyorsa) otomatik gizleme modundaki bir bölmenin davranışını belirler.
CDockablePane::IsInFloatingMultiPaneFrameWnd Bölmenin çok bölmeli çerçeve penceresinde olup olmadığını belirtir.
CDockablePane::IsResizable Bölmenin yeniden boyutlandırılabilir olup olmadığını belirtir.
CDockablePane::IsTabLocationBottom Sekmelerin bölmenin en üstünde mi yoksa en altında mı yer aldığını belirtir.
CDockablePane::IsTracked Bir bölmenin kullanıcı tarafından sürüklenip sürüklenmediğini belirtir.
CDockablePane::IsVisible Geçerli bölmenin görünür olup olmadığını belirler.
CDockablePane::LoadState Dahili olarak kullanılır.
CDockablePane::OnAfterChangeParent Bir bölmenin üst öğesi değiştiğinde çerçeve tarafından çağrılır. (Geçersiz Kılmalar CPane::OnAfterChangeParent.)
CDockablePane::OnAfterDockFromMiniFrame Kayan takma çubuğu bir çerçeve penceresine yerleştirildiğinde çerçeve tarafından çağrılır.
CDockablePane::OnBeforeChangeParent Bölmenin üst öğesi değişmek üzereyken çerçeve tarafından çağrılır. (Geçersiz Kılmalar CPane::OnBeforeChangeParent.)
CDockablePane::OnBeforeFloat Bir bölme kayarken çerçeve tarafından çağrılır. (Geçersiz Kılmalar CPane::OnBeforeFloat.)
CDockablePane::RemoveFromDefaultPaneDividier Bir bölme çıkarılırken çerçeve bu yöntemi çağırır.
CDockablePane::ReplacePane Bölmeyi belirtilen bir bölmeyle değiştirir.
CDockablePane::RestoreDefaultPaneDivider Çerçeve, bu yöntemi bir bölme olarak çağırır ve varsayılan bölme bölücüyü geri yüklemek için seri durumdan çıkarılır.
CDockablePane::SaveState Dahili olarak kullanılır.
CDockablePane::Serialize Bölmeyi serileştirir. (Geçersiz Kılmalar CBasePane::Serialize.)
CDockablePane::SetAutoHideMode Yerleştirme bölmesini görünür ve otomatik gizleme modu arasında değiştirir.
CDockablePane::SetAutoHideParents Bölme için otomatik gizle düğmesini ve otomatik gizle araç çubuğunu ayarlar.
CDockablePane::SetDefaultPaneDivider Dahili olarak kullanılır.
CDockablePane::SetLastPercentInPaneContainer Bir bölmenin kapsayıcı içinde kaplayan alan yüzdesini ayarlar.
CDockablePane::SetResizeMode Dahili olarak kullanılır.
CDockablePane::SetRestoredDefaultPaneDivider Geri yüklenen varsayılan bölme ayırıcısını ayarlar.
CDockablePane::SetTabbedPaneRTC İki bölme birbirine yerleştirildiğinde oluşturulan sekmeli pencere için çalışma zamanı sınıf bilgilerini ayarlar.
CDockablePane::ShowPane Bir bölmeyi gösterir veya gizler.
CDockablePane::Slide Yalnızca bölme otomatik gizleme modundayken görüntülenen kayan animasyon içeren bir bölmeyi gösterir veya gizler.
CDockablePane::ToggleAutoHide Otomatik gizleme modunu değiştirir. (Geçersiz Kılmalar CPane::ToggleAutoHide .)
CDockablePane::UndockPane Bir bölmeyi ana çerçeve penceresinden veya mini çerçeve penceresi kapsayıcısından çıkarır.
CDockablePane::UnSetAutoHideMode Dahili olarak kullanılır. Otomatik gizleme modunu ayarlamak için CDockablePane::SetAutoHideMode

Korumalı Yöntemler

Veri Akışı Adı Açıklama
CDockablePane::CheckAutoHideCondition Yerleştirme bölmesinin gizlenip gizlenmeyeceğini belirler (otomatik gizleme modunda).
CDockablePane::CheckStopSlideCondition Otomatik gizleme yerleştirme bölmesinin kaymayı ne zaman durdurması gerektiğini belirler.
CDockablePane::DrawCaption Yerleştirme bölmesi resim yazısını (kavrama) çizer.
CDockablePane::OnPressButtons Kullanıcı ve AFX_HTMAXBUTTON düğmeleri dışında bir resim yazısı düğmesine bastığında çağrılırAFX_HTCLOSE.
CDockablePane::OnSlide Bölme gösterildiğinde veya gizlendiğinde slayt efektini otomatik olarak gizlemek için çerçeve tarafından çağrılır.

Veri Üyeleri

Veri Akışı Adı Açıklama
CDockablePane::m_bDisableAnimation Yerleştirilebilir bölmenin otomatik gizle animasyonunun devre dışı bırakılıp bırakılmayacağını belirtir.
CDockablePane::m_bHideInAutoHideMode Bölme otomatik gizleme modundayken bölmenin davranışını belirler.
CDockablePane::m_nSlideSteps Otomatik gizleme modunda gösterildiğinde veya gizlendiğinde bölmenin animasyon hızını belirtir.

Açıklamalar

CDockablePane aşağıdaki işlevleri uygular:

  • Bir bölmeyi ana çerçeve penceresine yerleştirme.

  • Bölmeyi otomatik gizleme moduna geçirme.

  • Sekmeli pencereye bölme ekleme.

  • Mini çerçeve penceresinde bir bölmeyi kayan.

  • Bir bölmeyi, mini çerçeve penceresinde kayan başka bir bölmeye yerleştirme.

  • Bölmeyi yeniden boyutlandırma.

  • Yerleştirme bölmesi için yükleme ve kaydetme durumu.

    Not

    Durum bilgileri Windows kayıt defterine kaydedilir.

  • Resim yazısı olan veya olmayan bir bölme oluşturma. Resim yazısı bir metin etiketine sahip olabilir ve gradyan renkle doldurulabilir.

  • Bölmenin içeriğini görüntülerken bölmeyi sürükleme

  • Sürükleme dikdörtgeni görüntülenirken bir bölmeyi sürükleme.

Uygulamanızda bir yerleştirme bölmesi kullanmak için bölme sınıfınızı sınıfından türetin CDockablePane . Türetilmiş nesneyi ana çerçeve penceresi nesnesine veya bölmenizin örneğini denetleyen bir pencere nesnesine ekleyin. Ardından, ana çerçeve penceresinde iletiyi işlerken WM_CREATE yöntemini veya CDockablePane::CreateEx yöntemini çağırınCDockablePane::Create. Son olarak, , CBasePane::DockPaneveya CDockablePane::AttachToTabWndçağırarak CBasePane::EnableDockingbölme nesnesini ayarlayın.

Özelleştirme İpuçları

Nesneler için CDockablePane aşağıdaki ipuçları geçerlidir:

  • Sekmeli olmayan, sabitlenebilir iki bölme çağırırsanız CDockablePane::AttachToTabWnd , parametrede sekmeli pencere işaretçisi ppTabbedControlBar döndürülür. Bu parametreyi kullanarak sekmeli pencereye sekme eklemeye devam edebilirsiniz.

  • tarafından CDockablePane::AttachToTabWnd oluşturulan sekmeli bölme türü, parametresindeki CDockablePane pTabControlBarAttachTo nesne tarafından belirlenir. Öğesinin oluşturacağı sekmeli bölme türünü ayarlamak için CDockablePane öğesini çağırabilirsinizCDockablePane::SetTabbedPaneRTC. Varsayılan tür, öğesini ilk oluşturduğunuzda tarafından belirlenir dwTabbedStyle CDockablePane::Create.CDockablePane Varsayılan tür Sınıf iseCMFCOutlookBar, dwTabbedStyle AFX_CBRS_REGULAR_TABS varsayılan tür ise Sınıf'tırCTabbedPane.dwTabbedStyle AFX_CBRS_OUTLOOK_TABS

  • Bir sabitlenebilir bölmeyi başka bir bölmeye takmak istiyorsanız yöntemini çağırın CDockablePane::DockToWindow . Bu yöntemi çağırmadan önce özgün bölmenin bir yere sabitlenmiş olması gerekir.

  • Üye değişkeni CDockablePane::m_bHideInAutoHideMode , çağırdığınızda CDockablePane::ShowPaneyerleşik bölmelerin otomatik gizleme modunda nasıl davranacağını denetler. Bu üye değişkeni olarak TRUEayarlanırsa, yerleştirilebilir bölmeler ve bunların otomatik gizleme düğmeleri gizlenir. Aksi takdirde, içeri ve dışarı kaydırırlar.

  • Üye değişkenini TRUEolarak ayarlayarak animasyonu otomatik gizlemeyi CDockablePane::m_bDisableAnimation devre dışı bırakabilirsiniz.

Örnek

Aşağıdaki örnekte, sınıfındaki çeşitli yöntemleri kullanarak bir CDockablePane nesnenin nasıl yapılandırılır gösterilmektedir CDockablePane . Örnek, yerleştirilebilir bölme için tüm özellikleri otomatik olarak gizlemeyi etkinleştirmeyi, resim yazısını veya kavramayı etkinleştirmeyi, otomatik gizleme modunu etkinleştirmeyi, bölmeyi göstermeyi ve otomatik gizleme modundaki bir bölmeye animasyon eklemeyi gösterir. Bu kod parçacığı Visual Studio Tanıtım örneğinin bir parçasıdır.

// GetOwner is an inherited method.
CDockablePane *pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());

pParentBar->EnableAutohideAll();
pParentBar->EnableGripper(true);
pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
pParentBar->ShowPane(true, false, true);
pParentBar->Slide(true);

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

Gereksinimler

Üstbilgi: afxDockablePane.h

CDockablePane::AttachToTabWnd

Geçerli bölmeyi hedef bölmeye iliştirerek sekmeli bölme oluşturur.

virtual CDockablePane* AttachToTabWnd(
    CDockablePane* pTabControlBarAttachTo,
    AFX_DOCK_METHOD dockMethod,
    BOOL bSetActive= TRUE,
    CDockablePane** ppTabbedControlBar = NULL);

Parametreler

pTabControlBarAttachTo
[in, out] Geçerli bölmenin ekli olduğu hedef bölmeyi belirtir. Hedef bölme sabitlenebilir bir bölme olmalıdır.

dockMethod
[in] Yerleştirme yöntemini belirtir.

bSetActive
[in] TRUE ekleme işleminden sonra sekmeli bölmeyi etkinleştirmek için; aksi takdirde , FALSE.

ppTabbedControlBar
[out] Ekleme işleminden kaynaklanan sekmeli bölmeyi içerir.

Dönüş Değeri

Sekmeli bölme değilse geçerli bölmenin işaretçisi; aksi takdirde, ekleme işleminden kaynaklanan sekmeli bölmeye yönelik bir işaretçi. Dönüş değeri, NULL geçerli bölmenin eklenememe veya hata oluşmasıdır.

Açıklamalar

Bu yöntemi kullanarak yerleştirilebilir bir bölme başka bir bölmeye eklendiğinde, aşağıdakiler gerçekleşir:

  1. Çerçeve, hedef bölmenin pTabControlBarAttachTo normal bir yerleştirme bölmesi olup olmadığını veya 'den CBaseTabbedPanetüretilip türetmediğini denetler.

  2. Hedef bölme sekmeli bir bölmeyse, çerçeve geçerli bölmeyi sekme olarak ekler.

  3. Hedef bölme normal bir yerleştirme bölmesiyse, çerçeve sekmeli bir bölme oluşturur.

    • Çerçeve çağrısında bulunur pTabControlBarAttachTo->CreateTabbedPane. Yeni sekmeli bölmenin stili üyeye m_pTabbedControlBarRTC bağlıdır. Varsayılan olarak, bu üye çalışma zamanı sınıfına CTabbedPaneayarlanır. yönteminin AFX_CBRS_OUTLOOK_TABS parametresi CDockablePane::Create olarak dwTabbedStyle stili geçirirseniz, çalışma zamanı sınıfı nesnesi çalışma zamanı sınıfına CMFCOutlookBarayarlanır. Yeni bölmenin stilini değiştirmek için istediğiniz zaman bu üyeyi değiştirebilirsiniz.

    • Bu yöntem sekmeli bir bölme oluşturduğunda, çerçeve işaretçiyi yeni sekmeli bölmenin pTabControlBarAttachTo işaretçisiyle değiştirir (bölme yerleşikse veya çok mini çerçeveli bir pencerede kayansa).

    • Çerçeve, bölmeyi pTabControlBarAttachTo sekmeli bölmeye ilk sekme olarak ekler. Ardından çerçeve geçerli bölmeyi ikinci bir sekme olarak ekler.

  4. Geçerli bölme 'den CBaseTabbedPanetüretilirse, tüm sekmeleri öğesine taşınır pTabControlBarAttachTo ve geçerli bölme yok edilir. Bu nedenle, yöntem döndürdüğünde geçerli bölme işaretçisi geçersiz olabileceğinden, bu yöntemi çağırırken dikkatli olun.

Yerleştirme düzeni oluştururken bir bölmeyi diğerine eklerseniz olarak ayarlayın dockMethod DM_SHOW.

Başka bir bölme eklemeden önce ilk bölmeyi yerleştirmeniz gerekir.

CDockablePane::CalcFixedLayout

Bölme dikdörtgeninin boyutunu döndürür.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametreler

bStretch
[in] Kullanılmaz.

bHorz
[in] Kullanılmaz.

Dönüş Değeri

CSize Bölme dikdörtgeninin boyutunu içeren nesne.

CDockablePane::CanAcceptMiniFrame

Belirtilen mini çerçevenin bölmeye yerleştirilip yerleştirilemeyeceğini belirler.

virtual BOOL CanAcceptMiniFrame(CPaneFrameWnd* pMiniFrame) const;

Parametreler

pMiniFrame
[in] Nesne CPaneFrameWnd işaretçisi.

Dönüş Değeri

TRUE bölmeye yerleştirilebiliyorsa pMiniFrame ; değilse, FALSE.

CDockablePane::CanAcceptPane

Geçerli bölmeye başka bir bölmenin yerleştirilip yerleştirilemeyeceğini belirler.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Parametreler

pBar
[in] Geçerli bölmeye yerleştirecek bölmeyi belirtir.

Dönüş Değeri

TRUE belirtilen bölme bu bölmeye yerleştirilebiliyorsa; aksi takdirde , FALSE.

Açıklamalar

Bir bölme geçerli bölmeye yerleştirilmeden önce çerçeve bu yöntemi çağırır.

Belirli bir bölmeye yerleştirmeyi etkinleştirmek veya devre dışı bırakmak için türetilmiş bir sınıfta bu işlevi geçersiz kılın.

Varsayılan olarak, bu yöntem türündeyse veya üst öğesi türündeyse pBar CDockablePanedöndürürTRUE.

CDockablePane::CanAutoHide

Bölmenin otomatik olarak gizlenip gizlenemeyeceğini belirler.

virtual BOOL CanAutoHide() const;

Dönüş Değeri

TRUE bölme otomatik olarak gizlenebiliyorsa; aksi takdirde , FALSE.

Açıklamalar

CDockablePane::CanAutoHide aşağıdaki durumlardan herhangi birini döndürür FALSE :

  • Bölmenin üst öğesi yok.

  • Yerleştirme yöneticisi bölmelerin otomatik olarak gizlenebilmesine izin vermez.

  • Bölme yerleşik değil.

CDockablePane::CanBeAttached

Geçerli bölmenin başka bir bölmeye yerleştirilip yerleştirilemeyeceğini belirler.

virtual BOOL CanBeAttached() const;

Dönüş Değeri

TRUE sabitlenebilir bölme başka bir bölmeye veya ana çerçeve penceresine yerleştirilebiliyorsa; aksi takdirde , FALSE.

Açıklamalar

Varsayılan olarak, bu yöntem her zaman döndürür TRUE. çağırmadan CBasePane::EnableDockingyerleştirmeyi etkinleştirmek veya devre dışı bırakmak için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CDockablePane::CDockablePane

Bir CDockablePane nesneyi oluşturur ve başlatır.

CDockablePane();

Açıklamalar

Yerleştirilebilir bir bölme nesnesi oluşturduktan sonra veya CDockablePane::CreateEx öğesini çağırarak CDockablePane::Create oluşturun.

CDockablePane::ConvertToTabbedDocument

Bir veya daha fazla yerleşik bölmeyi MDI sekmeli belgelere dönüştürür.

virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);

Parametreler

bActiveTabOnly
[in] Bir CTabbedPaneöğesini dönüştürdüğünüzde, yalnızca etkin sekmeyi dönüştürmek için belirtin TRUE . Bölmedeki tüm sekmeleri dönüştürmek için belirtin FALSE .

CDockablePane::CheckAutoHideCondition

Yerleştirme bölmesinin gizlenip gizlenmeyeceğini belirler (otomatikhide modu olarak da bilinir).

virtual BOOL CheckAutoHideCondition();

Dönüş Değeri

TRUE gizleme koşulu karşılanırsa; aksi takdirde , FALSE.

Açıklamalar

Çerçeve, otomatik yerleşik bir bölmenin gizlenip gizlenmeyeceğini düzenli aralıklarla denetlemek için bir zamanlayıcı kullanır. yöntemi, bölme etkin olmadığında, bölme yeniden boyutlandırılmadığında ve fare işaretçisi bölmenin üzerinde olmadığında döndürür TRUE .

Önceki koşulların tümü karşılanırsa, çerçeve bölmeyi gizlemek için çağırır CDockablePane::Slide .

CDockablePane::CheckStopSlideCondition

Otomatik yerleştirme bölmesinin kaymayı ne zaman durdurması gerektiğini belirler.

virtual BOOL CheckStopSlideCondition(BOOL bDirection);

Parametreler

bDirection
[in] TRUE bölme görünür durumdaysa; FALSE bölme gizliyse.

Dönüş Değeri

TRUE durdurma koşulu karşılanırsa; aksi takdirde , FALSE.

Açıklamalar

Yerleştirilebilir bir bölme otomatik görüntüleme moduna ayarlandığında, çerçeve bölmeyi göstermek veya gizlemek için kayan efektleri kullanır. Çerçeve, bölme kaydığında bu işlevi çağırır. CheckStopSlideCondition bölme tamamen görünür olduğunda veya tamamen gizli olduğunda döndürür TRUE .

Özel otomatikhide efektleri uygulamak için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CDockablePane::CopyState

Yerleştirilebilir bölmenin durumunu kopyalar.

virtual void CopyState(CDockablePane* pOrgBar);

Parametreler

pOrgBar
[in] Yerleştirilebilir bölme işaretçisi.

Açıklamalar

CDockablePane::CopyState aşağıdaki yöntemleri çağırarak öğesinin pOrgBar durumunu geçerli bölmeye kopyalar:

CDockablePane::Create

Windows denetimini oluşturur ve nesneye CDockablePane ekler.

virtual BOOL Create(
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL);

virtual BOOL Create(
    LPCTSTR lpszWindowName,
    CWnd* pParentWnd,
    CSize sizeDefault,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle = WS_CHILD|WS_VISIBLE|CBRS_TOP|CBRS_HIDE_INPLACE,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE);

Parametreler

lpszCaption
[in] Pencere adını belirtir.

pParentWnd
[in, out] Üst pencereyi belirtir.

rect
[in] penceresinin boyutunu ve konumunu istemci koordinatlarında pParentWndbelirtir.

bHasGripper
[in] TRUE bir resim yazısı ile bölme oluşturmak için; aksi takdirde , FALSE.

nID
[in] Alt pencerenin kimliğini belirtir. Bu yerleştirme bölmesi için yerleştirme durumunu kaydetmek istiyorsanız bu değer benzersiz olmalıdır.

dwStyle
[in] Pencere stili özniteliklerini belirtir.

dwTabbedStyle
[in] Kullanıcı bu bölmenin resim yazısı üzerindeki bir bölmeyi sürüklediğinde oluşturulan sekmeli pencerenin sekmeli stilini belirtir.

dwControlBarStyle
[in] Ek stil özniteliklerini belirtir.

pContext
[in, out] Pencerenin oluşturma bağlamını belirtir.

lpszWindowName
[in] Pencere adını belirtir.

sizeDefault
[in] Pencerenin boyutunu belirtir.

Dönüş Değeri

TRUE yerleştirilebilir bölme başarıyla oluşturulduysa; aksi takdirde , FALSE.

Açıklamalar

Bir Windows bölmesi oluşturur ve bunu nesneye CDockablePane ekler.

dwStyle Pencere stili bayrağına CBRS_FLOAT_MULTI sahipse, mini çerçeve penceresi mini çerçeve penceresindeki diğer bölmelerle birlikte kayar. Varsayılan olarak, yerleştirme bölmeleri yalnızca tek tek kayar.

Parametresinde dwTabbedStyle belirtilen bayrak varsa, yöntemi kullanılarak CDockablePane::AttachToTabWnd bu bölmeye AFX_CBRS_OUTLOOK_TABS başka bir bölme eklendiğinde bölme Outlook stili sekmeli bölmeler oluşturur. Varsayılan olarak, sabitlenebilir bölmeler türünde CTabbedPanedüzenli sekmeli bölmeler oluşturur.

CDockablePane::CreateDefaultPaneDivider

Bir çerçeve penceresine yerleştirildiğinden bölme için varsayılan ayırıcı oluşturur.

static CPaneDivider* __stdcall CreateDefaultPaneDivider(
    DWORD dwAlignment,
    CWnd* pParent,
    CRuntimeClass* pSliderRTC = NULL);

Parametreler

dwAlignment
[in] Bölmenin yerleştirildiği ana çerçevenin tarafını belirtir. dwAlignment veya CBRS_ALIGN_RIGHT bayrağını içeriyorsaCBRS_ALIGN_LEFT, bu yöntem bir dikey (CPaneDivider::SS_VERT) ayırıcı oluşturur; aksi takdirde, bu yöntem yatay (CPaneDivider::SS_HORZ) ayırıcı oluşturur.

pParent
[in] Üst çerçevenin işaretçisi.

pSliderRTC
[in] Kullanılmaz.

Dönüş Değeri

Bu yöntem, yeni oluşturulan ayırıcıya bir işaretçi döndürür veya NULL ayırıcı oluşturma işlemi başarısız olursa.

Açıklamalar

dwAlignment aşağıdaki değerlerden herhangi biri olabilir:

Value Açıklama
CBRS_ALIGN_TOP Bölme, çerçeve penceresinin istemci alanının en üstüne yerleştiriliyor.
CBRS_ALIGN_BOTTOM Bölme, çerçeve penceresinin istemci alanının en altına yerleştiriliyor.
CBRS_ALIGN_LEFT Bölme, çerçeve penceresinin istemci alanının sol tarafına yerleştiriliyor.
CBRS_ALIGN_RIGHT Bölme, çerçeve penceresinin istemci alanının sağ tarafına yerleştiriliyor.

CDockablePane::CreateEx

Windows denetimini oluşturur ve nesneye CDockablePane ekler.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL);

Parametreler

dwStyleEx
[in] Yeni pencere için genişletilmiş stil özniteliklerini belirtir.

lpszCaption
[in] Pencere adını belirtir.

pParentWnd
[in, out] Üst pencereyi belirtir.

rect
[in] penceresinin boyutunu ve konumunu istemci koordinatlarında pParentWndbelirtir.

bHasGripper
[in] TRUE bir resim yazısı ile bölme oluşturmak için; aksi takdirde , FALSE.

nID
[in] Alt pencerenin kimliğini belirtir. Bu yerleştirme bölmesi için yerleştirme durumunu kaydetmek istiyorsanız bu değer benzersiz olmalıdır.

dwStyle
[in] Pencere stili özniteliklerini belirtir.

dwTabbedStyle
[in] Kullanıcı bu bölmenin resim yazısı üzerindeki bir bölmeyi sürüklediğinde oluşturulan sekmeli pencerenin sekmeli stilini belirtir.

dwControlBarStyle
[in] Ek stil özniteliklerini belirtir.

pContext
[in, out] Pencerenin oluşturma bağlamını belirtir.

Dönüş Değeri

TRUE yerleştirilebilir bölme başarıyla oluşturulduysa; aksi takdirde , FALSE.

Açıklamalar

Bir Windows bölmesi oluşturur ve bunu nesneye CDockablePane ekler.

dwStyle Pencere stili bayrağına CBRS_FLOAT_MULTI sahipse, mini çerçeve penceresi mini çerçeve penceresindeki diğer bölmelerle birlikte kayar. Varsayılan olarak, yerleştirme bölmeleri yalnızca tek tek kayar.

Parametresinde dwTabbedStyle belirtilen bayrak varsa, yöntemi kullanılarak CDockablePane::AttachToTabWnd bu bölmeye AFX_CBRS_OUTLOOK_TABS başka bir bölme eklendiğinde bölme Outlook stili sekmeli bölmeler oluşturur. Varsayılan olarak, sabitlenebilir bölmeler türünde CTabbedPanedüzenli sekmeli bölmeler oluşturur.

CDockablePane::CreateTabbedPane

Geçerli bölmeden sekmeli bir bölme oluşturur.

virtual CTabbedPane* CreateTabbedPane();

Dönüş Değeri

Yeni sekmeli bölme veya NULL oluşturma işlemi başarısız olduysa.

Açıklamalar

Çerçeve, bu bölmeyi değiştirmek için sekmeli bir bölme oluşturduğunda bu yöntemi çağırır. Daha fazla bilgi için bkz. CDockablePane::AttachToTabWnd.

Sekmeli bölmelerin nasıl oluşturulup başlatıldığını özelleştirmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

Sekmeli bölme, yöntemi tarafından başlatılan üyede m_pTabbedControlBarRTC depolanan çalışma zamanı sınıf bilgilerine CDockablePane::CreateEx göre oluşturulur.

CDockablePane::DockPaneContainer

Kapsayıcıyı bölmeye sabitler.

virtual BOOL DockPaneContainer(
    CPaneContainerManager& barContainerManager,
    DWORD dwAlignment,
    AFX_DOCK_METHOD dockMethod);

Parametreler

barContainerManager
[in] Yerleştirilmekte olan kapsayıcının kapsayıcı yöneticisine başvuru.

dwAlignment
[in] DWORD kapsayıcının yerleştirildiği bölmenin kenarını belirtir.

dockMethod
[in] Kullanılmaz.

Dönüş Değeri

TRUE kapsayıcı bölmeye başarıyla yerleştirilmişse; aksi takdirde , FALSE.

Açıklamalar

dwAlignment aşağıdaki değerlerden herhangi biri olabilir:

Value Açıklama
CBRS_ALIGN_TOP Kapsayıcı, bölmenin en üstüne yerleştiriliyor.
CBRS_ALIGN_BOTTOM Kapsayıcı, bölmenin en altına yerleştiriliyor.
CBRS_ALIGN_LEFT Kapsayıcı bölmenin soluna yerleştiriliyor.
CBRS_ALIGN_RIGHT Kapsayıcı, bölmenin sağındaki yerleşik olarak yerleştiriliyor.

CDockablePane::DockPaneStandard

Ana hat (standart) yerleştirmeyi kullanarak bir bölmeyi sabitler.

virtual CPane* DockPaneStandard(BOOL& bWasDocked);

Parametreler

bWasDocked
[in] Yöntemi döndürdüğünde, bu değer bölmenin başarıyla yerleştirilip yerleştirildiğini içerir TRUE ; aksi takdirde içerir FALSE.

Dönüş Değeri

Bölme sekmeli bir pencereye yerleştirilmişse veya yerleştirmenin bir sonucu olarak sekmeli bir pencere oluşturulduysa, bu yöntem sekmeli pencereye bir işaretçi döndürür. Bölme başarıyla yerleştirilmişse, bu yöntem işaretçiyi this döndürür. Yerleştirme başarısız olursa, bu yöntem döndürür NULL.

CDockablePane::DockToRecentPos

Bir bölmeyi depolanmış yerleştirme konumuna yerleştirir.

BOOL CDockablePane::DockToRecentPos();

Dönüş Değeri

TRUE bölme başarıyla yerleştirilmişse; aksi takdirde , FALSE.

Açıklamalar

Yerleştirilebilir bölmeler, son yerleştirme bilgilerini bir CRecentDockSiteInfo nesnede depolar.

CDockablePane::DockToWindow

Bir yerleştirme bölmesini başka bir yerleştirme bölmesine sabitler.

virtual BOOL DockToWindow(
    CDockablePane* pTargetWindow,
    DWORD dwAlignment,
    LPCRECT lpRect = NULL);

Parametreler

pTargetWindow
[in, out] Bu bölmenin yerleştirilebilen bölmesini belirtir.

dwAlignment
[in] Bölme için yerleştirme hizalamasını belirtir. , , CBRS_ALIGN_BOTTOM CBRS_ALIGN_TOPCBRS_ALIGN_RIGHTveya CBRS_ALIGN_ANYtürlerinden CBRS_ALIGN_LEFTbiri olabilir. (. afxres.h)

lpRect
[in] Bölme için yerleştirme dikdörtgenini belirtir.

Dönüş Değeri

TRUE bölme başarıyla yerleştirildiyse; aksi takdirde , FALSE.

Açıklamalar

Tarafından belirtilen dwAlignmenthizalamayla bir bölmeyi başka bir bölmeye yerleştirmek için bu yöntemi çağırın.

CDockablePane::DrawCaption

Yerleştirme bölmesinin resim yazısını (kavrama olarak da adlandırılır) çizer.

virtual void DrawCaption(
    CDC* pDC,
    CRect rectCaption);

Parametreler

pDC
[in] Çizim için kullanılan cihaz bağlamını temsil eder.

rectCaption
[in] Bölmenin resim yazısının sınırlayıcı dikdörtgenini belirtir.

Açıklamalar

Çerçeve, yerleştirilebilir bir bölmenin resim yazısını çizmek için bu yöntemi çağırır.

Açıklamalı alt yazının görünümünü özelleştirmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CDockablePane::EnableAutohideAll

Bu bölme ve kapsayıcıdaki diğer bölmeler için otomatik görüntüleme modunu etkinleştirir veya devre dışı bırakır.

void EnableAutohideAll(BOOL bEnable = TRUE);

Parametreler

bEnable
[in] TRUE yerleştirilebilir bölmenin tüm özelliklerini otomatik olarak göstermeyi etkinleştirmek için; aksi takdirde , FALSE.

Açıklamalar

Kullanıcı Ctrl tuşunu basılı tutarak sabitle düğmesine tıklayarak bir bölmeyi otomatik görüntüleme moduna geçtiğinde, aynı kapsayıcıdaki diğer tüm bölmeler de otomatik görüntüleme moduna geçirilir.

Belirli bir bölmede FALSE bu özelliği devre dışı bırakmak için set ile bEnable bu yöntemi çağırabilirsiniz.

CDockablePane::EnableGripper

Resim yazısını gösterir veya gizler (kavrama olarak da adlandırılır).

virtual void EnableGripper(BOOL bEnable);

Parametreler

bEnable
[in] TRUE resim yazısını etkinleştirmek için; aksi takdirde , FALSE.

Açıklamalar

Çerçeve sabitlenebilir bölmeler oluşturduğunda WS_STYLE , belirtilmiş olsa bile pencere stiline sahip olmazlar. Bu, bölmenin resim yazısının çerçeve tarafından denetlenen istemci olmayan bir alan olduğu, ancak bu alanın standart pencere resim yazısından farklı olduğu anlamına gelir.

Resim yazısını istediğiniz zaman gösterebilir veya gizleyebilirsiniz. Çerçeve, bir bölme sekmeli pencereye sekme olarak eklendiğinde veya bir bölme mini çerçeve penceresinde kaydırıldığında resim yazısını gizler.

CDockablePane::GetAHRestoredRect

Otomatik gizleme modundayken bölmenin konumunu belirtir.

CRect GetAHRestoredRect() const;

Dönüş Değeri

CRect Otomatik gizleme modundayken bölmenin konumunu içeren nesne.

Açıklamalar

CDockablePane::GetAHSlideMode

Bölme için slayt modunu otomatik gizlemeyi alır.

virtual UINT GetAHSlideMode() const;

Dönüş Değeri

UINT Bölme için slayt modunu otomatik olarak gizlemeyi belirten bir. Dönüş değeri veya AFX_AHSM_STRETCHolabilirAFX_AHSM_MOVE, ancak uygulama yalnızca kullanırAFX_AHSM_MOVE.

Açıklamalar

CDockablePane::GetCaptionHeight

Geçerli resim yazısının yüksekliğini piksel cinsinden döndürür.

virtual int GetCaptionHeight() const;

Dönüş Değeri

Resim yazısının piksel cinsinden yüksekliği.

Açıklamalar

Resim yazısı yöntemi tarafından gizlenmişse veya bölmede CDockablePane::EnableGripper resim yazısı yoksa resim yazısı yüksekliği 0'dır.

CDockablePane::GetDefaultPaneDivider

Bölmenin kapsayıcısı için varsayılan bölme ayırıcısını döndürür.

CPaneDivider* GetDefaultPaneDivider() const;

Dönüş Değeri

Sabitlenebilir bölme ana çerçeve penceresine yerleştirilmişse veya yerleştirilebilir bölme sabitlenmemişse veya NULL kayansa geçerli CPaneDivider bir nesne.

Açıklamalar

Bölme bölücüleri hakkında daha fazla bilgi için bkz CPaneDivider . Sınıf.

CDockablePane::GetDockingStatus

Sağlanan işaretçi konumuna göre bölmenin yerleştirilebilme becerisini belirler.

virtual AFX_CS_STATUS GetDockingStatus(
    CPoint pt,
    int nSensitivity);

Parametreler

pt
[in] İşaretçinin ekran koordinatlarındaki konumu.

nSensitivity
[in] Yerleştirmeyi etkinleştirmek için işaretçinin dikdörtgenin kenarından uzak olması gereken uzaklık piksel cinsindendir.

Dönüş Değeri

Aşağıdaki durum değerlerinden biri:

AFX_CS_STATUS değer Anlamı
CS_NOTHING İşaretçi bir takma birimi sitesinin üzerinde değil. Çerçeve bölmeyi yerleştirmez.
CS_DOCK_IMMEDIATELY İşaretçi, dock sitesinin üzerinde anında modda bulunur (bölmede yerleştirme modu kullanılır DT_IMMEDIATE ). Çerçeve, bölmeyi hemen sabitler.
CS_DELAY_DOCK İşaretçi, başka bir yerleştirme bölmesi olan veya ana çerçevenin kenarı olan bir takma birimi sitesinin üzerindedir. Çerçeve, bir gecikmeden sonra bölmeyi sabitler. Bu gecikme hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.
CS_DELAY_DOCK_TO_TAB İşaretçi, bölmenin sekmeli bir pencereye yerleştirilmesine neden olan bir dock sitesinin üzerinde bulunur. Bu, işaretçi başka bir yerleştirme bölmesinin resim yazısının üzerinde veya sekmeli bölmenin sekme alanının üzerinde bulunduğunda oluşur.

Açıklamalar

Çerçeve, kayan bölmenin yerleştirme işlemini işlemek için bu yöntemi çağırır.

Yerleştirme modunu kullanan DT_IMMEDIATE kayan araç çubukları veya yerleştirme bölmeleri için, çerçeve takma birimi komutunu geciktirerek yerleştirme işlemi gerçekleşmeden önce kullanıcının pencereyi üst çerçevenin istemci alanından dışarı taşımasını sağlar. Gecikme süresi milisaniye cinsinden ölçülür ve veri üyesi tarafından CDockingManager::m_nTimeOutBeforeToolBarDock denetlenmektedir... varsayılan değeri CDockingManager::m_nTimeOutBeforeToolBarDock 200'dür. Bu davranış, Microsoft Word 2007'nin yerleştirme davranışına öykünmektedir.

Gecikmeli yerleştirme durumları (CS_DELAY_DOCK ve CS_DELAY_DOCK_TO_TAB) için, kullanıcı fare düğmesini serbest bırakana kadar çerçeve yerleştirme gerçekleştirmez. Bölmede yerleştirme modu kullanılıyorsa DT_STANDARD çerçeve, öngörülen yerleştirme konumunda bir dikdörtgen görüntüler. Bölmede yerleştirme modu kullanılıyorsa DT_SMART çerçeve, öngörülen yerleştirme konumunda akıllı yerleştirme işaretçileri ve yarı saydam dikdörtgenler görüntüler. Bölmeniz için yerleştirme modunu belirtmek için yöntemini çağırın CBasePane::SetDockingMode . Akıllı yerleştirme hakkında daha fazla bilgi için bkz CDockingManager::GetSmartDockingParams. .

CDockablePane::GetDragSensitivity

Yerleştirme bölmesinin sürükleme duyarlılığını döndürür.

static const CSize& GetDragSensitivity();

Dönüş Değeri

Sürükleme CSize noktası üzerinde ortalanmış bir dikdörtgenin genişliğini ve yüksekliğini piksel cinsinden içeren nesne. Fare işaretçisi bu dikdörtgenin dışına taşınana kadar sürükleme işlemi başlamaz.

CDockablePane::GetLastPercentInPaneContainer

Bir bölmenin kapsayıcısında kaplayan alan yüzdesini alır ( CPaneContainer Sınıf).

int GetLastPercentInPaneContainer() const;

Dönüş Değeri

Bölmenin int kapsayıcısında kaplayan alan yüzdesini belirten bir.

Açıklamalar

Bu yöntem, kapsayıcı düzenini ayarladığında kullanılır.

CDockablePane::GetTabArea

Bölmenin sekme alanını alır.

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

Parametreler

rectTabAreaTop
[in] GetTabArea sekmeler bölmenin en üstünde yer alıyorsa bu değişkeni sekme alanıyla doldurur. Sekmeler bölmenin en altında yer alıyorsa, bu değişken boş bir dikdörtgenle doldurulur.

rectTabAreaBottom
[in] GetTabArea sekmeler bölmenin en altında yer alıyorsa bu değişkeni sekme alanıyla doldurur. Sekmeler bölmenin en üstünde yer alıyorsa, bu değişken boş bir dikdörtgenle doldurulur.

Açıklamalar

Bu yöntem yalnızca türetilen CDockablePane ve sekmeleri olan sınıflarda kullanılır. Daha fazla bilgi için bkz. CTabbedPane::GetTabArea ve CMFCOutlookBar::GetTabArea.

CDockablePane::GetTabbedPaneRTC

Başka bir bölme geçerli bölmeye yerleştirildiğinde oluşturulan sekmeli pencereyle ilgili çalışma zamanı sınıf bilgilerini döndürür.

CRuntimeClass* GetTabbedPaneRTC() const;

Dönüş Değeri

Yerleştirilebilir bölme için çalışma zamanı sınıf bilgileri.

Açıklamalar

Dinamik olarak oluşturulan sekmeli bölmeler için çalışma zamanı sınıf bilgilerini almak için bu yöntemi çağırın. Bu durum, kullanıcı bir bölmeyi başka bir bölmenin resim yazısına sürüklediğinde veya iki yerleşik bölmeden program aracılığıyla sekmeli bölme oluşturmak için yöntemini çağırdığınızda CDockablePane::AttachToTabWnd oluşabilir.

yöntemini çağırarak CDockablePane::SetTabbedPaneRTC çalışma zamanı sınıf bilgilerini ayarlayabilirsiniz.

CDockablePane::HasAutoHideMode

Bir yerleştirme bölmesinin otomatik görüntüleme moduna geçirilip geçirilemeyeceğini belirtir.

virtual BOOL HasAutoHideMode() const;

Dönüş Değeri

TRUE sabitlenebilir bölme otomatik mod moduna geçirilebiliyorsa; aksi takdirde , FALSE.

Açıklamalar

Belirli bir yerleştirilebilir bölmede otomatikhide modunu devre dışı bırakmak için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CDockablePane::HitTest

Kullanıcının fareyi tıklattığı bölmedeki konumu belirtir.

virtual int HitTest(
    CPoint point,
    BOOL bDetectCaption = FALSE);

Parametreler

point
[in] Test noktası belirtir.

bDetectCaption
[in] TRUE nokta HTCAPTION bölmenin resim yazısı üzerindeyse döndürülmelidir; aksi takdirde , FALSE.

Dönüş Değeri

Aşağıdaki değerlerden biri:

  • HTNOWHERE sabitlenebilir point bölmede değilse.

  • HTCLIENT sabitlenebilir bölmenin istemci alanındaysa point .

  • HTCAPTION yerleştirilebilir bölmenin resim yazısı alanındaysa point .

  • AFX_HTCLOSE kapat düğmesindeyse point .

  • HTMAXBUTTON sabitle düğmesindeyse point .

CDockablePane::IsAutohideAllEnabled

Kapsayıcıdaki yerleştirme bölmesinin ve diğer tüm bölmelerin otomatik görüntüleme moduna geçirilip geçirilemeyeceğini gösterir.

virtual BOOL IsAutohideAllEnabled() const;

Dönüş Değeri

TRUE sabitlenebilir bölme ve kapsayıcıdaki diğer tüm bölmeler otomatik görüntüleme moduna geçirilebilirse; aksi takdirde , FALSE.

Açıklamalar

Kullanıcı, Ctrl tuşunu basılı tutarken docking pin düğmesine tıklayarak otomatik görüntüleme modunu etkinleştirir

Bu davranışı etkinleştirmek veya devre dışı bırakmak için yöntemini çağırın CDockablePane::EnableAutohideAll .

CDockablePane::IsAutoHideMode

Bir bölmenin otomatik gösterme modunda olup olmadığını belirler.

virtual BOOL IsAutoHideMode() const;

Dönüş Değeri

TRUE yerleştirilebilir bölme otomatik görüntüleme modundaysa; aksi takdirde , FALSE.

CDockablePane::IsDocked

Geçerli bölmenin yerleşik olup olmadığını belirler.

virtual BOOL IsDocked() const;

Dönüş Değeri

TRUE sabitlenebilir bölme bir mini çerçeve penceresine ait değilse veya başka bir bölmeyle bir mini çerçeve penceresinde kayan ise. FALSE bölme bir mini çerçeve penceresinin alt öğesiyse ve mini çerçeve penceresine ait başka bölme yoksa.

Açıklamalar

Bölmenin ana çerçeve penceresine yerleştirilip yerleştirılmadığını belirlemek için çağrısı yapın CDockablePane::GetDefaultPaneDivider. Yöntem işaretçi olmayanNULL bir değer döndürürse, bölme ana çerçeve penceresine yerleştirilmiştir.

CDockablePane::IsHideInAutoHideMode

öğesini çağırarak CDockablePane::ShowPanegösteriliyorsa (veya gizleniyorsa) otomatik görüntüleme modundaki bir bölmenin davranışını belirler.

virtual BOOL IsHideInAutoHideMode() const;

Dönüş Değeri

TRUE otomatikhide modundayken yerleştirilebilir bölmenin gizlenmesi gerekiyorsa; aksi takdirde , FALSE.

Açıklamalar

Yerleştirilebilir bir bölme otomatik görüntüleme modundayken, bölmeyi gizlemek veya göstermek için çağırdığınızda ShowPane farklı davranır. Bu davranış statik üyesi CDockablePane::m_bHideInAutoHideModetarafından denetlenır. Bu üye ise TRUE, öğesini çağırdığınızda ShowPaneyerleşik bölme ve ilgili otomatik görüntü araç çubuğu veya otomatik göster düğmesi gizlenir veya gösterilir. Aksi takdirde, yerleştirilebilir bölme etkinleştirilir veya devre dışı bırakılır ve ilgili otomatik görüntüleme araç çubuğu veya otomatik göster düğmesi her zaman görünür.

Tek tek bölmeler için varsayılan davranışı değiştirmek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

için m_bHideInAutoHideMode varsayılan değerdir FALSE.

CDockablePane::IsInFloatingMultiPaneFrameWnd

Bölmenin çok bölmeli çerçeve penceresinde ( CMultiPaneFrameWnd Class) olup olmadığını belirtir.

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Dönüş Değeri

TRUE bölme çok bölmeli bir çerçeve penceresindeyse; aksi takdirde , FALSE.

Açıklamalar

CDockablePane::IsResizable

Bölmenin yeniden boyutlandırılabilir olup olmadığını belirtir.

virtual BOOL IsResizable() const;

Dönüş Değeri

TRUE bölme yeniden boyutlandırılabilirse; aksi takdirde , FALSE.

Açıklamalar

Varsayılan olarak, yerleştirilebilir bölmeler yeniden boyutlandırılabilir. Yeniden boyutlandırmayı önlemek için, türetilmiş bir sınıfta bu yöntemi geçersiz kılın ve döndürür FALSE. Bir FALSE değerin içinde başarısız ASSERT olmasına yol açtığını CPane::DockPaneunutmayın. Bunun yerine bir bölmeyi üst çerçeve içine yerleştirmeyi kullanın CDockingManager::AddPane .

Yeniden boyutlandırılmayan bölmeler kayar veya otomatik gizleme moduna giremez ve her zaman üst çerçevenin dış kenarında bulunur.

CDockablePane::IsTabLocationBottom

Sekmelerin bölmenin en üstünde mi yoksa en altında mı yer aldığını belirtir.

virtual BOOL IsTabLocationBottom() const;

Dönüş Değeri

TRUE sekmeler bölmenin en altında yer alıyorsa; FALSE sekmeler bölmenin en üstünde yer alıyorsa.

Açıklamalar

Daha fazla bilgi için bkz. CTabbedPane::IsTabLocationBottom.

CDockablePane::IsTracked

Bir bölmenin kullanıcı tarafından taşınıp taşınmadığını belirtir.

BOOL IsTracked() const;

Dönüş Değeri

TRUE bölme taşınıyorsa; aksi takdirde , FALSE.

CDockablePane::IsVisible

Geçerli bölmenin görünür olup olmadığını belirler.

virtual BOOL IsVisible() const;

Dönüş Değeri

TRUE sabitlenebilir bölme görünür durumdaysa; aksi takdirde , FALSE.

Açıklamalar

Yerleştirilebilir bir bölmenin görünür olup olmadığını belirlemek için bu yöntemi çağırabilirsiniz. Stili çağırmak CWnd::IsWindowVisible veya sınamak WS_VISIBLE yerine bu yöntemi kullanabilirsiniz. Döndürülen görünürlük durumu, otomatik görüntüleme modunun etkin veya devre dışı olmasına ve özelliğin CDockablePane::IsHideInAutoHideMode değerine bağlıdır.

Yerleştirilebilir bölme otomatik görüntüleme modundaysa ve IsHideInAutoHideMode görünürlük durumunu döndürüyorsa FALSE her zaman FALSEolur.

Yerleştirilebilir bölme otomatik görüntüleme modundaysa ve IsHideInAutoHideMode görünürlük durumunu döndürüyorsa TRUE ilgili otomatik görüntüleme araç çubuğunun görünürlük durumuna bağlıdır.

Yerleştirilebilir bölme otomatik görüntüleme modunda değilse görünürlük durumu yöntemi tarafından CBasePane::IsVisible belirlenir.

## CDockablePane::LoadState

Yalnızca şirket içi kullanım içindir. Daha fazla ayrıntı için Visual Studio yüklemenizin mfc klasöründe bulunan kaynak koduna bakın. Örneğin, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL LoadState(
   LPCTSTR lpszProfileName = NULL,
   int nIndex = -1,
   UINT uiID = (UINT) -1
);

CDockablePane::m_bDisableAnimation

Yerleştirilebilir bölmenin otomatik görüntüleme animasyonunun devre dışı bırakılıp bırakılmayacağını belirtir.

AFX_IMPORT_DATA static BOOL m_bDisableAnimation;

CDockablePane::m_bHideInAutoHideMode

Bölme otomatik görüntüleme modundayken bölmenin davranışını belirler.

AFX_IMPORT_DATA static BOOL m_bHideInAutoHideMode;

Açıklamalar

Bu değer, uygulamadaki tüm yerleştirme bölmelerini etkiler.

Bu üyeyi olarak TRUEayarlarsanız, çağırdığınızda CDockablePane::ShowPaneyerleşik bölmeler gizlenir veya ilgili otomatik görüntü araç çubukları ve düğmeleriyle gösterilir.

Bu üyeyi olarak FALSEayarlarsanız, çağırdığınızda CDockablePane::ShowPanesabitlenebilir bölmeler etkinleştirilir veya devre dışı bırakılır.

CDockablePane::m_nSlideSteps

Bölmenin otomatik görüntüleme modundayken animasyon hızını belirtir.

AFX_IMPORT_DATA static int m_nSlideSteps;

Açıklamalar

Daha hızlı bir animasyon efekti için bu değeri azaltın. Daha yavaş bir animasyon efekti için bu değeri artırın.

CDockablePane::OnAfterChangeParent

Daha fazla ayrıntı için Visual Studio yüklemenizin mfc klasöründe bulunan kaynak koduna bakın. Örneğin, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Parametreler

[in] pWndOldParent\

Açıklamalar

CDockablePane::OnAfterDockFromMiniFrame

Kayan takma çubuğu bir çerçeve penceresine yerleştirildiğinde çerçeve tarafından çağrılır.

virtual void OnAfterDockFromMiniFrame();

Açıklamalar

Varsayılan olarak, bu yöntem hiçbir şey yapmaz.

CDockablePane::OnBeforeChangeParent

Çerçeve, bölmenin üst öğesini değiştirmeden önce bu yöntemi çağırır.

virtual void OnBeforeChangeParent(
    CWnd* pWndNewParent,
    BOOL bDelay = FALSE);

Parametreler

pWndNewParent
[in] Yeni üst pencerenin işaretçisi.

bDelay
[in] Bölme çıkarılırsa yerleştirme düzeninin yeniden hesaplanmasında gecikme yapılıp yapılmayacağını belirten BOOL. Daha fazla bilgi için bkz. CDockablePane::UndockPane.

Açıklamalar

Bölme yerleşikse ve yeni üst öğe yerleştirmeye izin vermiyorsa, bu yöntem bölmeyi çıkarır.

Bölme sekmeli belgeye dönüştürülüyorsa, bu yöntem son yerleştirme konumunu depolar. Çerçeve, bölmenin yerleşik duruma geri dönüştürüldüğü konumu geri yüklemek için en son yerleştirme konumunu kullanır.

CDockablePane::OnBeforeFloat

Çerçeve, bir bölme kayan duruma geçmeden önce bu yöntemi çağırır.

virtual BOOL OnBeforeFloat(
    CRect& rectFloat,
    AFX_DOCK_METHOD dockMethod);

Parametreler

rectFloat
[in] Kayan durumdayken bölmenin konumunu ve boyutunu belirtir.

dockMethod
[in] Yerleştirme yöntemini belirtir. Olası değerlerin listesi için bkz CPane::DockPane .

Dönüş Değeri

TRUE bölme kaydırılabilirse; aksi takdirde , FALSE.

Açıklamalar

Bu yöntem, bir bölme kayarken çerçeve tarafından çağrılır. Bölme kayar önce herhangi bir işlem gerçekleştirmek istiyorsanız türetilmiş bir sınıfta bu yöntemi geçersiz kılabilirsiniz.

CDockablePane::OnPressButtons

Kullanıcı ve AFX_HTMAXBUTTON düğmeleri dışında bir resim yazısı düğmesine bastığında çağrılırAFX_HTCLOSE.

virtual void OnPressButtons(UINT nHit);

Parametreler

nHit
[in] Bu parametre kullanılmaz.

Açıklamalar

Yerleştirilebilir bir bölmenin resim yazısına özel bir düğme eklerseniz, kullanıcı düğmeye bastığında bildirim almak için bu yöntemi geçersiz kılın.

CDockablePane::OnSlide

Otomatik görüntüleme modundayken bölmeye animasyon eklemek için çerçeve tarafından çağrılır.

virtual void OnSlide(BOOL bSlideOut);

Parametreler

bSlideOut
[in] TRUE bölmeyi göstermek için; FALSE öğesini seçin.

Açıklamalar

Özel otomatikhide efektleri uygulamak için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CDockablePane::RemoveFromDefaultPaneDividier

Bir bölme çıkarılırken çerçeve bu yöntemi çağırır.

void RemoveFromDefaultPaneDividier();

Açıklamalar

Bu yöntem, varsayılan bölme ayırıcısını olarak NULL ayarlar ve kapsayıcısından bölmeyi kaldırır.

CDockablePane::ReplacePane

Bölmeyi belirtilen bir bölmeyle değiştirir.

BOOL ReplacePane(
    CDockablePane* pBarToReplaceWith,
    AFX_DOCK_METHOD dockMethod,
    BOOL bRegisterWithFrame = FALSE);

Parametreler

pBarToReplaceWith
[in] Yerleştirilebilir bölme işaretçisi.

dockMethod
[in] Kullanılmaz.

bRegisterWithFrame
[in] ise TRUE, yeni bölme eski bölmenin üst öğesinin takma yöneticisine kaydedilir. Yeni bölme, yerleştirme yöneticisi tarafından tutulan bölmeler listesinde eski bölmenin dizinine eklenir.

Dönüş Değeri

TRUE değiştirme başarılı olursa; aksi takdirde , FALSE.

CDockablePane::RestoreDefaultPaneDivider

Bir bölme seri durumdan çıkarıldığında, çerçeve varsayılan bölme ayırıcısını geri yüklemek için bu yöntemi çağırır.

void RestoreDefaultPaneDivider();

Açıklamalar

Geri yüklenen varsayılan bölme bölücü, varsa geçerli varsayılan bölme ayırıcısının yerini alır.

CDockablePane::SetAutoHideMode

Yerleştirme bölmesini görünür ve otomatik görüntüleme modu arasında değiştirir.

virtual CMFCAutoHideBar* SetAutoHideMode(
    BOOL bMode,
    DWORD dwAlignment,
    CMFCAutoHideBar* pCurrAutoHideBar = NULL,
    BOOL bUseTimer = TRUE);

Parametreler

bMode
[in] TRUE otomatik görüntüleme modunu etkinleştirmek için; FALSE normal yerleştirme modunu etkinleştirmek için.

dwAlignment
[in] Oluşturulacak otomatikhide bölmesinin hizalamasını belirtir.

pCurrAutoHideBar
[in, out] Geçerli otomatik görüntüleme araç çubuğunun işaretçisi. olabilir NULL.

bUseTimer
[in] Kullanıcı bölmeyi otomatik görüntüleme moduna geçirirken veya bölmeyi hemen gizlediğinde otomatikhide efektinin kullanılıp kullanılmayacağını belirtir.

Dönüş Değeri

Otomatik görüntüleme moduna geçmenin sonucu olarak oluşturulan otomatik görüntüleme araç çubuğu veya NULL.

Açıklamalar

Bir kullanıcı sabitlenebilir bölmeyi otomatik görüntüleme moduna veya normal yerleştirme moduna geçmek için sabitle düğmesine tıkladığında çerçeve bu yöntemi çağırır.

Yerleşik bir bölmeyi program aracılığıyla otomatik mod moduna geçmek için bu yöntemi çağırın. Bölme ana çerçeve penceresine yerleştirilmelidir ( CDockablePane::GetDefaultPaneDivider için geçerli bir işaretçi CPaneDividerdöndürmelidir).

CDockablePane::SetAutoHideParents

Bölme için otomatik gizle düğmesini ve otomatik gizle araç çubuğunu ayarlar.

void SetAutoHideParents(
    CMFCAutoHideBar* pToolBar,
    CMFCAutoHideButton* pBtn);

Parametreler

pToolBar
[in] Otomatik gizleme araç çubuğunun işaretçisi.

pBtn
[in] Otomatik gizle düğmesinin işaretçisi.

CDockablePane::SetLastPercentInPaneContainer

Bir bölmenin kapsayıcısında kaplayan alan yüzdesini ayarlar.

void SetLastPercentInPaneContainer(int n);

Parametreler

n
[in] Bölmenin int kapsayıcısında kaplayan alan yüzdesini belirten bir.

Açıklamalar

Çerçeve, düzen yeniden hesaplandığında bölmeyi yeni değeri kullanacak şekilde ayarlar.

CDockablePane::SetRestoredDefaultPaneDivider

Geri yüklenen varsayılan bölme ayırıcısını ayarlar.

void SetRestoredDefaultPaneDivider(HWND hRestoredSlider);

Parametreler

hRestoredSlider
[in] Bölme ayırıcısı tutamacı (kaydırıcı).

Açıklamalar

Bir bölme seri durumdan çıkarıldığında geri yüklenen varsayılan bölme ayırıcısı elde edilir. Daha fazla bilgi için bkz. CDockablePane::RestoreDefaultPaneDivider.

CDockablePane::SetTabbedPaneRTC

İki bölme birbirine yerleştirildiğinde oluşturulan sekmeli pencere için çalışma zamanı sınıf bilgilerini ayarlar.

void SetTabbedPaneRTC(CRuntimeClass* pRTC);

Parametreler

pRTC
[in] Sekmeli bölme için çalışma zamanı sınıf bilgileri.

Açıklamalar

Dinamik olarak oluşturulan sekmeli bölmeler için çalışma zamanı sınıf bilgilerini ayarlamak için bu yöntemi çağırın. Bu durum, kullanıcı bir bölmeyi başka bir bölmenin resim yazısına sürüklediğinde veya iki yerleşik bölmeden program aracılığıyla sekmeli bölme oluşturmak için yöntemini çağırdığınızda CDockablePane::AttachToTabWnd oluşabilir.

Varsayılan çalışma zamanı sınıfı ve CDockablePane::CreateExparametresine dwTabbedStyle CDockablePane::Create göre ayarlanır. Yeni sekmeli bölmeleri özelleştirmek için sınıfınızı aşağıdaki sınıflardan birinden türetin:

Ardından, çalışma zamanı sınıf bilgileri işaretçisi ile bu yöntemi çağırın.

CDockablePane::ShowPane

Bir bölmeyi gösterir veya gizler.

virtual void ShowPane(
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parametreler

bShow
[in] TRUE bölmeyi göstermek için; FALSE öğesini seçin.

bDelay
[in] TRUE yerleştirme düzenini ayarlamayı geciktirmek için; FALSE 'yi seçerek yerleştirme düzenini hemen ayarlayın.

bActivate
[in] TRUE gösterildiğinde bölmeyi etkinleştirmek için; aksi takdirde , FALSE.

Açıklamalar

Yerleştirilebilir bölmeleri gösterirken veya gizlerken yerine CWnd::ShowWindow bu yöntemi çağırın.

CDockablePane::Slide

Otomatik görüntüleme modundaki bir bölmeye animasyon ekler.

virtual void Slide(
    BOOL bSlideOut,
    BOOL bUseTimer = TRUE);

Parametreler

bSlideOut
[in] TRUE bölmeyi göstermek için; FALSE öğesini seçin.

bUseTimer
[in] TRUE otomatik gösterim efektiyle bölmeyi göstermek veya gizlemek için; FALSE öğesini seçin.

Açıklamalar

Çerçeve, otomatik görüntüleme modundaki bir bölmeye animasyon eklemek için bu yöntemi çağırır.

Bu yöntem, CDockablePane::m_nSlideDefaultTimeOut slayt efekti için zaman aşımını belirlemek için değerini kullanır. Zaman aşımı için varsayılan değer 1'dir. Otomatik gösterme algoritmasını özelleştirirseniz, zaman aşımını değiştirmek için bu üyeyi değiştirin.

CDockablePane::ToggleAutoHide

Bölmeyi her zaman görünür ve otomatik gizleme modu arasında değiştirir.

virtual void ToggleAutoHide();

Açıklamalar

Bu yöntem, öğesini çağırarak CDockablePane::SetAutoHideModebölme için otomatik gizleme modunu değiştirir.

CDockablePane::UndockPane

Bir bölmeyi ana çerçeve penceresinden veya mini çerçeve penceresi kapsayıcısından çıkarır.

virtual void UndockPane(BOOL bDelay = FALSE);

Parametreler

bDelay
[in] TRUE yerleştirme düzenini hesaplamayı geciktirmek için; FALSE docking düzenini hemen yeniden hesaplamak için.

Açıklamalar

Ana çerçeve penceresinden veya çok mini çerçeveli pencere kapsayıcısından (diğer bölmelerle tek bir mini çerçeve penceresinde kayan bir bölme) bölmeyi çıkarmak için bu yöntemi çağırın.

tarafından gerçekleştirilmeyecek herhangi bir dış işlemi gerçekleştirmeden önce bir bölmeyi CDockingManagerçıkarmanız gerekir. Örneğin, program aracılığıyla bir konumdan diğerine taşımak için bölmeyi çıkarmanız gerekir.

Çerçeve, bölmeleri yok edilmeden önce otomatik olarak çıkarır.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CPane Sınıf