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

Genel Oluşturucular

Ad Açıklama
CDockablePane::CDockablePane bir CDockablePane nesnesi oluşturur ve başlatır.

Genel Yöntemler

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 CDockablePane nesnesine 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 CDockablePane nesnesine 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 CPane::DockPane veya CDockablePane::DockToWindowkullanın.
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 ShowPaneçağrılarak gö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

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ı AFX_HTCLOSE ve AFX_HTMAXBUTTON düğmeleri dışında bir resim yazısı düğmesine bastığında çağrılır.
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

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ı CDockablePane sınıfından türetin. Türetilmiş nesneyi ana çerçeve penceresi nesnesine veya bölmenizin örneğini denetleyen bir pencere nesnesine ekleyin. Ardından ana çerçeve penceresinde CDockablePane::Create iletisini işlerken CDockablePane::CreateEx yöntemini veya WM_CREATE yöntemini çağırın. Son olarak, CBasePane::EnableDocking, CBasePane::DockPaneveya CDockablePane::AttachToTabWndçağırarak bölme nesnesini ayarlayın.

Özelleştirme İpuçları

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

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

  • CDockablePane::AttachToTabWnd tarafından oluşturulan sekmeli bölme türü, CDockablePane parametresindeki pTabControlBarAttachTo nesnesi tarafından belirlenir. CDockablePane::SetTabbedPaneRTC oluşturacağı sekmeli bölme türünü ayarlamak için CDockablePane çağırabilirsiniz. Varsayılan tür, dwTabbedStyleilk oluşturduğunuzda CDockablePane::CreateCDockablePane tarafından belirlenir. varsayılan tür Sınıf; varsayılan tür sınıf.

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

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

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

Örnek

Aşağıdaki örnekte, CDockablePane sınıfında çeşitli yöntemler kullanarak bir CDockablePane nesnesinin nasıl yapılandırılır gösterilmektedir. Ö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ğibir 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

Gereksinim -leri

Üst Bilgisi: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);

Parametre

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] ekleme işleminden sonra sekmeli bölmeyi etkinleştirmek için TRUE; 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. Geçerli bölme eklenemediyse veya bir hata oluşursa dönüş değeri NULL.

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 CBaseTabbedPanetüretilmiş olup olmadığını 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 pTabControlBarAttachTo->CreateTabbedPaneçağırır. Yeni sekmeli bölmenin stili, m_pTabbedControlBarRTC üyeye bağlıdır. Varsayılan olarak, bu üye CTabbedPaneçalışma zamanı sınıfına ayarlanır. AFX_CBRS_OUTLOOK_TABS stilini dwTabbedStyle parametresi olarak CDockablePane::Create yöntemine geçirirseniz, çalışma zamanı sınıfı nesnesi CMFCOutlookBarçalışma zamanı sınıfına ayarlanı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 pTabControlBarAttachTo (bölme çok mini çerçeveli bir pencerede yerleşikse veya kayansa) ile yeni sekmeli bölmeye yönelik bir işaretçiyle değiştirir.

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

  4. Geçerli bölme CBaseTabbedPanetüretilirse, tüm sekmeleri pTabControlBarAttachTo taşınır 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, dockMethodDM_SHOWolarak ayarlayın.

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

Parametre

bStretch
[in] Kullanılmaz.

bHorz
[in] Kullanılmaz.

Dönüş Değeri

Bölme dikdörtgeninin boyutunu içeren bir CSize nesnesi.

CDockablePane::CanAcceptMiniFrame

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

virtual BOOL CanAcceptMiniFrame(CPaneFrameWnd* pMiniFrame) const;

Parametre

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

Dönüş Değeri

TRUE bölmeye yerleştirilip yerleştirilebileceğini pMiniFrame; aksi takdirde, 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;

Parametre

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

Dönüş Değeri

Belirtilen bölmenin bu bölmeye yerleştirilip yerleştirilmediğini TRUE; 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, TRUE veya üst öğesi pBartüründeyse bu yöntem CDockablePane döndürür.

CDockablePane::CanAutoHide

Bölmenin otomatik olarak gizlenip gizlenemeyeceğini belirler.

virtual BOOL CanAutoHide() const;

Dönüş Değeri

Bölmenin otomatik olarak gizlenip gizlenmediğini TRUE; aksi takdirde FALSE.

Açıklamalar

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

  • 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

Sabitlenebilir bölmenin başka bir bölmeye mi yoksa ana çerçeve penceresine mi yerleştirilebileceğini TRUE; aksi takdirde FALSE.

Açıklamalar

Varsayılan olarak, bu yöntem her zaman TRUEdöndürür. CBasePane::EnableDockingçağırmadan yerleş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 nesnesi oluşturur ve başlatır.

CDockablePane();

Açıklamalar

Yerleşik bir bölme nesnesi oluşturduktan sonra, CDockablePane::Create veya CDockablePane::CreateEx çağırarak 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);

Parametre

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

CDockablePane::CheckAutoHideCondition

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

virtual BOOL CheckAutoHideCondition();

Dönüş Değeri

Gizleme koşulunun karşılanması durumunda TRUE; 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 TRUE döndürür.

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

CDockablePane::CheckStopSlideCondition

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

virtual BOOL CheckStopSlideCondition(BOOL bDirection);

Parametre

bDirection
[in] bölmenin görünür olup olmadığını TRUE; Bölmenin gizlenip gizlenmediğini FALSE.

Dönüş Değeri

Durdurma koşulunun karşılanması durumunda TRUE; 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 gizlendiğinde TRUE döndürür.

Ö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);

Parametre

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

Açıklamalar

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

CDockablePane::Create

Windows denetimini oluşturur ve CDockablePane nesnesine 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);

Parametre

lpszCaption
[in] Pencere adını belirtir.

pParentWnd
[in, out] Üst pencereyi belirtir.

rect
[in] pencerenin boyutunu ve konumunu pParentWndistemci koordinatlarında belirtir.

bHasGripper
[in] bölmeyi açıklamalı alt yazıyla oluşturmak için TRUE; 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

Yerleştirilebilir bölmenin başarıyla oluşturulup oluşturulmadiğini TRUE; aksi takdirde FALSE.

Açıklamalar

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

dwStyle pencere stilinde CBRS_FLOAT_MULTI bayrağı varsa, 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.

dwTabbedStyle parametresinde belirtilen AFX_CBRS_OUTLOOK_TABS bayrağı varsa, CDockablePane::AttachToTabWnd yöntemi kullanılarak bu bölmeye başka bir bölme eklendiğinde bölme Outlook stili sekmeli bölmeler oluşturur. Varsayılan olarak, sabitlenebilir bölmeler CTabbedPanetüründe normal 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);

Parametre

dwAlignment
[in] Bölmenin yerleştirildiği ana çerçevenin tarafını belirtir. dwAlignment CBRS_ALIGN_LEFT veya CBRS_ALIGN_RIGHT bayrağı içeriyorsa, bu yöntem 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 ayırıcı oluşturma işlemi başarısız olursa NULL.

Açıklamalar

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

Değer 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 CDockablePane nesnesine 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);

Parametre

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] pencerenin boyutunu ve konumunu pParentWndistemci koordinatlarında belirtir.

bHasGripper
[in] bölmeyi açıklamalı alt yazıyla oluşturmak için TRUE; 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

Yerleştirilebilir bölmenin başarıyla oluşturulup oluşturulmadiğini TRUE; aksi takdirde FALSE.

Açıklamalar

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

dwStyle pencere stilinde CBRS_FLOAT_MULTI bayrağı varsa, 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.

dwTabbedStyle parametresinde belirtilen AFX_CBRS_OUTLOOK_TABS bayrağı varsa, CDockablePane::AttachToTabWnd yöntemi kullanılarak bu bölmeye başka bir bölme eklendiğinde bölme Outlook stili sekmeli bölmeler oluşturur. Varsayılan olarak, sabitlenebilir bölmeler CTabbedPanetüründe normal 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 oluşturma işleminin başarısız olup olmadığını NULL.

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, m_pTabbedControlBarRTC yöntemi tarafından başlatılan CDockablePane::CreateEx üyesinde depolanan çalışma zamanı sınıf bilgilerine göre oluşturulur.

CDockablePane::DockPaneContainer

Kapsayıcıyı bölmeye sabitler.

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

Parametre

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

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

dockMethod
[in] Kullanılmaz.

Dönüş Değeri

Kapsayıcının bölmeye başarıyla yerleştirilip yerleştirildiğini TRUE; aksi takdirde FALSE.

Açıklamalar

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

Değer 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);

Parametre

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

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 this işaretçisini döndürür. Yerleştirme başarısız olursa, bu yöntem NULLdöndürür.

CDockablePane::DockToRecentPos

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

BOOL CDockablePane::DockToRecentPos();

Dönüş Değeri

Bölmenin başarıyla yerleştirilip yerleştirnmediğini TRUE; aksi takdirde FALSE.

Açıklamalar

Yerleştirilebilir bölmeler en son yerleştirme bilgilerini bir CRecentDockSiteInfo nesnesinde 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);

Parametre

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

dwAlignment
[in] Bölme için yerleştirme hizalamasını belirtir. CBRS_ALIGN_LEFT, CBRS_ALIGN_TOP, CBRS_ALIGN_RIGHT, CBRS_ALIGN_BOTTOM veya CBRS_ALIGN_ANYolabilir. (afxres.hiçinde tanımlanır.)

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

Dönüş Değeri

Bölmenin başarıyla yerleştirilip yerleştirildiğini TRUE; aksi takdirde FALSE.

Açıklamalar

dwAlignmenttarafından belirtilen hizalamayla 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);

Parametre

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

Parametre

bEnable
[in] TRUE dockable bölmesi için tüm özellikleri otomatik olarak göster özelliğini etkinleştirmek için; aksi takdirde FALSE.

Açıklamalar

Kullanıcı Ctrl tuşunu tuttuğunda ve bir bölmeyi otomatik görüntüleme moduna geçmek için sabitle düğmesine tıkladığında, aynı kapsayıcıdaki diğer tüm bölmeler de otomatik görüntüleme moduna geçirilir.

Belirli bir bölmede bu özelliği devre dışı bırakmak için bEnableFALSE olarak ayarlanmış 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);

Parametre

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

Açıklamalar

Çerçeve sabitlenebilir bölmeler oluşturduğunda, belirtilmiş olsa bile WS_STYLE 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

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

Açıklamalar

CDockablePane::GetAHSlideMode

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

virtual UINT GetAHSlideMode() const;

Dönüş Değeri

Bölme için slayt modunu otomatik gizlemeyi belirten bir UINT. Dönüş değeri AFX_AHSM_MOVE veya AFX_AHSM_STRETCHolabilir, ancak uygulama yalnızca AFX_AHSM_MOVEkullanır.

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ı CDockablePane::EnableGripper yöntemi tarafından gizlenmişse veya bölmede resim yazısı yoksa resim yazısı yüksekliği 0 olur.

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

Yerleşik bölme ana çerçeve penceresine yerleştirilmişse geçerli bir CPaneDivider nesnesi veya sabitlenebilir bölme yerleşik değilse veya kayan ise NULL.

Açıklamalar

Bölme bölücüleri hakkında daha fazla bilgi için bkz. 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);

Parametre

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ğeri 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 anlık modda bulunur (bölmede DT_IMMEDIATE yerleştirme modu kullanılır). Ç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.

DT_IMMEDIATE yerleştirme modunu kullanan 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 CDockingManager::m_nTimeOutBeforeToolBarDock veri üyesi tarafından denetlenmektedir. CDockingManager::m_nTimeOutBeforeToolBarDock varsayılan değeri 200'dür. Bu davranış, Microsoft Word 2007'nin yerleştirme davranışına öykünmektedir.

Gecikmeli yerleştirme durumları için (CS_DELAY_DOCK ve CS_DELAY_DOCK_TO_TAB), kullanıcı fare düğmesini serbest bırakana kadar çerçeve yerleştirme gerçekleştirmez. Bölmede DT_STANDARD yerleştirme modu kullanılıyorsa çerçeve, öngörülen yerleştirme konumunda bir dikdörtgen görüntüler. Bölmede DT_SMART yerleştirme modu kullanılıyorsa ç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ölmenizin takma modunu belirtmek için CBasePane::SetDockingMode yöntemini çağırın. 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 noktasında ortalanmış bir dikdörtgenin genişliğini ve yüksekliğini piksel cinsinden içeren CSize nesnesi. 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 kapsayıcısında kaplayan alan yüzdesini belirten bir int.

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;

Parametre

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 CDockablePane türetilen 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 CDockablePane::AttachToTabWnd yöntemini çağırdığınızda oluşabilir.

CDockablePane::SetTabbedPaneRTC yöntemini çağırarak ç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

Sabitlenebilir bölmenin otomatik görüntüleme moduna geçirilip geçirilmediğini TRUE; 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);

Parametre

point
[in] Test noktası belirtir.

bDetectCaption
[in] Nokta bölmenin resim yazısındaysa TRUE döndürülmesi gerekip gerekmediğini HTCAPTION; aksi takdirde, FALSE.

Dönüş Değeri

Aşağıdaki değerlerden biri:

  • HTNOWHERE yerleştirilebilir bölmede değilse point.

  • HTCLIENT yerleştirilebilir bölmenin istemci alanında olup olmadığını point.

  • HTCAPTION yerleştirilebilir bölmenin resim yazısı alanında olup olmadığını point.

  • Kapat düğmesinde AFX_HTCLOSE olup olmadığını point.

  • sabitleme düğmesinde HTMAXBUTTON olup olmadığını 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

Sabitlenebilir bölmenin ve kapsayıcıdaki diğer tüm bölmelerin otomatik görüntüleme moduna geçirilip geçirilmediğini TRUE; aksi takdirde FALSE.

Açıklamalar

Kullanıcı, Ctrl tuşunu basılı tutarak yerleştirme sabitleme düğmesine tıklayarak otomatik görüntüleme modunu etkinleştirir

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

CDockablePane::IsAutoHideMode

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

virtual BOOL IsAutoHideMode() const;

Dönüş Değeri

Sabitlenebilir bölmenin otomatik görüntüleme modunda olup olmadığını TRUE; aksi takdirde FALSE.

CDockablePane::IsDocked

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

virtual BOOL IsDocked() const;

Dönüş Değeri

Sabitlenebilir bölmenin bir mini çerçeve penceresine ait olup olmadığını veya başka bir bölmeyle bir mini çerçeve penceresinde kayan olup olmadığını TRUE. Bölmenin bir mini çerçeve penceresinin alt öğesi olup olmadığını ve mini çerçeve penceresine ait başka bölmeler olup olmadığını FALSE.

Açıklamalar

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

CDockablePane::IsHideInAutoHideMode

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

virtual BOOL IsHideInAutoHideMode() const;

Dönüş Değeri

Otomatikhideme modundayken yerleştirilebilir bölmenin gizlenip gizlenmediğini TRUE; aksi takdirde FALSE.

Açıklamalar

Yerleştirilebilir bir bölme otomatik gösterme modundayken, bölmeyi gizlemek veya göstermek için ShowPane çağırdığınızda farklı davranır. Bu davranış, CDockablePane::m_bHideInAutoHideModestatik üye tarafından denetlenır. Bu üye TRUEise, sabitlenebilir bölme ve ilgili otomatik göster araç çubuğu veya otomatik göster düğmesi gizlenir veya ShowPaneçağırdığınızda 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.

m_bHideInAutoHideMode için varsayılan değer FALSEdeğeridir.

CDockablePane::IsInFloatingMultiPaneFrameWnd

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

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Dönüş Değeri

Bölmenin çok bölmeli çerçeve penceresinde olup olmadığını TRUE; 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

Bölmenin yeniden boyutlandırılabilir olup olmadığını TRUE; aksi takdirde FALSE.

Açıklamalar

Varsayılan olarak, yerleştirilebilir bölmeler yeniden boyutlandırılabilir. Yeniden boyutlandırmayı önlemek için bu yöntemi türetilmiş bir sınıfta geçersiz kılın ve FALSEdöndürin. FALSE değerinin ASSERTiçinde başarısız CPane::DockPane yol açtığını unutmayın. Bir bölmeyi üst çerçeveye yerleştirmek için bunun yerine CDockingManager::AddPane kullanın.

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

Sekmelerin bölmenin en altında yer aldığını TRUE; Sekmelerin bölmenin en üstünde yer aldığını FALSE.

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

Bölmenin taşınıp taşınmadığını TRUE; 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

Sabitlenebilir bölmenin görünür olup olmadığını TRUE; 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. CWnd::IsWindowVisible çağırmak veya WS_VISIBLE stili için test yapmak 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 CDockablePane::IsHideInAutoHideMode özelliğinin değerine bağlıdır.

Yerleştirilebilir bölme otomatik gösterme modundaysa ve IsHideInAutoHideMode görünürlük durumunun her zaman FALSEFALSE döndürür.

Yerleştirilebilir bölme otomatik görüntüleme modundaysa ve IsHideInAutoHideModeTRUE döndürüyorsa, görünürlük durumu ilgili otomatik taşıma 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 CBasePane::IsVisible yöntemi tarafından belirlenir.

## CDockablePane::LoadState

Yalnızca dahili kullanım için. 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 TRUEolarak ayarlarsanız, CDockablePane::ShowPaneçağırdığınızda yerleşik bölmeler gizlenir veya ilgili otomatik araç çubukları ve düğmeleriyle gösterilir.

Bu üyeyi FALSEolarak ayarlarsanız, CDockablePane::ShowPaneçağırdığınızda sabitlenebilir 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);

Parametre

[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);

Parametre

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

Parametre

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

Bölmenin kaydırılıp kaydırılmadığını TRUE; 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ı AFX_HTCLOSE ve AFX_HTMAXBUTTON düğmeleri dışında bir resim yazısı düğmesine bastığında çağrılır.

virtual void OnPressButtons(UINT nHit);

Parametre

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

Parametre

bSlideOut
[in] bölmeyi göstermek için TRUE; Bölmeyi gizlemek için FALSE.

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ı NULL olarak ayarlar ve bölmeyi kapsayıcısından 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);

Parametre

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

dockMethod
[in] Kullanılmaz.

bRegisterWithFrame
[in] TRUEyeni bölme, eski bölmenin üst öğesinin yerleştirme 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

Değiştirmenin başarılı olup olmadığını TRUE; 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);

Parametre

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

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. NULLolabilir.

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çme veya NULLsonucunda oluşturulan otomatik görüntüleme araç çubuğu.

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::GetDefaultPaneDividerCPaneDivideriçin geçerli bir işaretçi dö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);

Parametre

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

Parametre

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

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

Parametre

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

Parametre

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 CDockablePane::AttachToTabWnd yöntemini çağırdığınızda oluşabilir.

Varsayılan çalışma zamanı sınıfı, dwTabbedStyle ve CDockablePane::CreateCDockablePane::CreateEx parametresine 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);

Parametre

bShow
[in] bölmeyi göstermek için TRUE; Bölmeyi gizlemek için FALSE.

bDelay
[in] Yerleştirme düzenini ayarlamayı geciktirmek için TRUE; Yerleştirme düzenini hemen ayarlamak için FALSE.

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

Açıklamalar

Yerleştirilebilir bölmeleri gösterirken veya gizlerken CWnd::ShowWindow yerine 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);

Parametre

bSlideOut
[in] bölmeyi göstermek için TRUE; Bölmeyi gizlemek için FALSE.

bUseTimer
[in] Otomatik gösterim efektiyle bölmeyi göstermek veya gizlemek için TRUE; Bölmeyi hemen göstermek veya gizlemek için FALSE.

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, slayt efekti için zaman aşımını belirlemek için CDockablePane::m_nSlideDefaultTimeOut 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, CDockablePane::SetAutoHideModeçağrısı yaparak bö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);

Parametre

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

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.

CDockingManagertarafından gerçekleştirilmeyecek herhangi bir dış işlemi gerçekleştirmeden önce bölmeyi çı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