CBasePane 類別

所有窗格的基底類別實作。

class CBasePane : public CWnd

Members

公用建構函式

名稱	描述
CBasePane::CBasePane	預設建構函式。
CBasePane::~CBasePane	解構函式。

公用方法

名稱	描述
CBasePane::accHitTest	呼叫由架構擷取子項目或子物件在畫面上的指定點。 (覆寫 CWnd::accHitTest)。
CBasePane::accLocation	呼叫由架構擷取指定物件的目前螢幕位置。 (覆寫 CWnd::accLocation)。
CBasePane::AccNotifyObjectFocusEvent	CBasePane 不使用這個方法。
CBasePane::accSelect	呼叫框架修改選取範圍或移動指定物件的鍵盤焦點。 (覆寫 CWnd::accSelect)。
CBasePane::AddPane	將處理常式加入至停駐窗格。
CBasePane::AdjustDockingLayout	將一個呼叫重新導向至停駐管理員調整停駐配置。
CBasePane::AdjustLayout	呼叫框架，該窗格應該調整其內部設定。
CBasePane::CalcFixedLayout	計算控制列的水平大小。
CBasePane::CanAcceptPane	判斷其他窗格是否可以停駐窗格。
CBasePane::CanAutoHide	判斷 窗格是否支援自動隱藏模式。
CBasePane::CanBeAttached	判斷是否可停駐窗格加入至另一個窗格。
CBasePane::CanBeClosed	判斷窗格是否可以關閉。
CBasePane::CanBeDocked	判斷是否可停駐窗格加入至另一個窗格。
CBasePane::CanBeResized	判斷窗格是否可以調整大小。
CBasePane::CanBeTabbedDocument	指定窗格是否可以轉換為 MDI 索引標籤式文件。
CBasePane::CanFloat	判斷是否可以浮動窗格。
CBasePane::CanFocus	指定窗格是否可以接收焦點。
CBasePane::CopyState	複製指定窗格的狀態。
CBasePane::CreateDefaultMiniframe	如果可以浮動窗格，建立小型框架視窗。
CBasePane::CreateEx	建立窗格控制項。
CBasePane::DockPane	停駐窗格加入至另一個窗格或到框架視窗。
CBasePane::DockPaneUsingRTTI	您可以使用執行階段型別資訊，停駐窗格。
CBasePane::DockToFrameWindow	內建可停駐窗格至框架。
CBasePane::DoesAllowDynInsertBefore	判斷其他窗格是否能夠以動態方式插入這個窗格和父框架之間。
CBasePane::EnableDocking	啟用窗格的停駐到主要畫面格。
CBasePane::EnableGripper	啟用或停用移駐夾。 移駐夾有效，使用者可以將它重新定位窗格。
CBasePane::FillWindowRect	內部使用。
CBasePane::FloatPane	浮動窗格。
CBasePane::get_accChild	呼叫由架構擷取一 IDispatch 介面位址指定的子系。 (覆寫 CWnd::get_accChild)。
CBasePane::get_accChildCount	呼叫由架構擷取屬於這個物件的子系數目。 (覆寫 CWnd::get_accChildCount)。
CBasePane::get_accDefaultAction	呼叫由架構擷取描述物件的預設動作的字串。 (覆寫 CWnd::get_accDefaultAction)。
CBasePane::get_accDescription	呼叫由架構擷取描述指定物件之視覺外觀的字串。 (覆寫 CWnd::get_accDescription)。
CBasePane::get_accFocus	呼叫由架構擷取具有鍵盤焦點的物件。 (覆寫 CWnd::get_accFocus)。
CBasePane::get_accHelp	呼叫由架構擷取物件的說明屬性字串。 (覆寫 CWnd::get_accHelp)。
CBasePane::get_accHelpTopic	呼叫由架構擷取與指定的物件和適當的主題識別項在該檔案中 WinHelpfile的完整路徑。 (覆寫 CWnd::get_accHelpTopic)。
CBasePane::get_accKeyboardShortcut	呼叫由架構擷取物件的指定快速鍵。 (覆寫 CWnd::get_accKeyboardShortcut)。
CBasePane::get_accName	呼叫由架構擷取指定物件的名稱。 (覆寫 CWnd::get_accName)。
CBasePane::get_accParent	呼叫由架構擷取物件的父代的 IDispatch 介面。 (覆寫 CWnd::get_accParent)。
CBasePane::get_accRole	呼叫由架構擷取描述指定之物件的相關資訊。 (覆寫 CWnd::get_accRole)。
CBasePane::get_accSelection	呼叫由架構來擷取這個的選項之子系的物件。 (覆寫 CWnd::get_accSelection)。
CBasePane::get_accState	呼叫由架構擷取指定物件的目前狀態。 (覆寫 CWnd::get_accState)。
CBasePane::get_accValue	呼叫由架構擷取指定物件的值。 (覆寫 CWnd::get_accValue)。
CBasePane::GetCaptionHeight	傳回標題高度。
CBasePane::GetControlBarStyle	傳回控制項的樣式。
CBasePane::GetCurrentAlignment	傳回目前窗格對齊。
CBasePane::GetDockingMode	傳回目前停駐窗格的方式。
CBasePane::GetDockSiteFrameWnd	會將指標傳至檔案是窗格的停駐網站的視窗。
CBasePane::GetEnabledAlignment	傳回套用至 窗格中的 CBRS_ALIGN_ 樣式。
CBasePane::GetMFCStyle	傳回窗格樣式專屬於 MFC。
CBasePane::GetPaneIcon	將控制代碼傳回給窗格圖示。
CBasePane::GetPaneRect	內部使用。
CBasePane::GetPaneRow	傳回指向窗格停駐的 CDockingPanesRow物件。
CBasePane::GetPaneStyle	傳回窗格樣式。
CBasePane::GetParentDockSite	會將指標傳至父內建網站。
CBasePane::GetParentMiniFrame	會將指標傳至父小型框架視窗。
CBasePane::GetParentTabbedPane	會將指標傳至父代的索引窗格。
CBasePane::GetParentTabWnd	會將指標傳至索引標籤內的父視窗。
CBasePane::GetRecentVisibleState	在 窗格中，從檔案還原時，架構會呼叫這個方法。
CBasePane::HideInPrintPreviewMode	指定窗格是否在預覽列印隱藏。
CBasePane::InsertPane	註冊處理常式的指定停駐的窗格。
CBasePane::IsAccessibilityCompatible	指定窗格是否支援 Active Accessibility。
CBasePane::IsAutoHideMode	判斷是否在窗格自動隱藏模式。
CBasePane::IsDialogControl	指定窗格是否為對話方塊控制項。
CBasePane::IsDocked	判斷是否停駐窗格。
CBasePane::IsFloating	判斷是否浮動窗格。
CBasePane::IsHorizontal	判斷是否水平停駐窗格。
CBasePane::IsInFloatingMultiPaneFrameWnd	指定窗格是否在多窗格框架視窗。
CBasePane::IsMDITabbed	判斷窗格是否已加入至 MDI 子視窗，因為一個索引標籤式文件。
CBasePane::IsPaneVisible	指定 WS_VISIBLE 旗標是否已設定窗格。
CBasePane::IsPointNearDockSite	判斷指定的點是否包含在固定網站附近。
CBasePane::IsResizable	判斷窗格是否可以調整大小。
CBasePane::IsRestoredFromRegistry	判斷 窗格是否從註冊還原。
CBasePane::IsTabbed	判斷是否在窗格的索引標籤式視窗的索引標籤控制項會在此處。
CBasePane::IsTooltipTopmost	內部使用。
CBasePane::IsVisible	判斷窗格是否可見。
CBasePane::LoadState	從登錄載入窗格狀態。
CBasePane::MoveWindow	捲動窗格。
CBasePane::OnAfterChangeParent	呼叫框架，在變更窗格的父代。
CBasePane::OnBeforeChangeParent	在 窗格中呼叫之前的框架變更它的父視窗。
CBasePane::OnDrawCaption	在繪製時，架構會呼叫這個方法標頭。
CBasePane::OnMovePaneDivider	目前未使用這個方法。
CBasePane::OnPaneContextMenu	呼叫由架構，在建立具有 窗格的清單中的功能表。
CBasePane::OnRemoveFromMiniFrame	呼叫框架，該窗格從其父代 (Parent) 微型框架視窗中移除。
CBasePane::OnSetAccData	CBasePane 不使用這個方法。
CBasePane::OnUpdateCmdUI	內部使用。
CBasePane::PaneFromPoint	傳回包含指定點的窗格。
CBasePane::PreTranslateMessage	由類別 CWinApp 將 Windows 訊息，然後才會傳送至 TranslateMessage 和 DispatchMessage Windows 函式之前。 (覆寫 CWnd::PreTranslateMessage)。
CBasePane::RecalcLayout	CBasePane 不使用這個方法。
CBasePane::RemovePaneFromDockManager	將窗格與停駐管理員的清單中移除。
CBasePane::SaveState	儲存窗格的狀態變更登錄。
CBasePane::SelectDefaultFont	針對指定的裝置內容來選取預設字型。
CBasePane::Serialize	讀取或寫入這個物件從或其中的檔案。 (覆寫 CObject::Serialize)。
CBasePane::SetControlBarStyle	設定控制項的樣式。
CBasePane::SetDockingMode	將窗格設定為的控制項。
CBasePane::SetMDITabbed	內部使用。
CBasePane::SetPaneAlignment	將窗格的對齊方式。
CBasePane::SetPaneRect	內部使用。
CBasePane::SetPaneStyle	將窗格設定的樣式。
CBasePane::SetRestoredFromRegistry	內部使用。
CBasePane::SetWindowPos	變更窗格的大小、位置和疊置順序。
CBasePane::ShowPane	顯示或隱藏窗格。
CBasePane::StretchPane	垂直或水平縮放控制] 窗格。
CBasePane::UndockPane	從目前停駐的內建網站、預設滑桿或小型框架視窗中移除窗格。

受保護的方法

名稱	描述
CBasePane::DoPaint	填滿窗格的背景。

備註

如果您想要建立支援擴充停駐功能可在窗格中的 MFC 類別，您必須衍生自 CBasePane 或從 CPane 類別。

自訂秘訣

繼承自的下列自訂提示與 CBasePane 類別 和任何類別:

• 當您建立窗格時，您可以將數個新樣式:

  • AFX_CBRS_FLOAT 執行窗格浮動。

  • AFX_CBRS_AUTOHIDE 啟動自動隱藏模式。

  • AFX_CBRS_CLOSE 讓窗格關閉 (隱藏)。

  這些是您可以結合位元 OR 作業的旗標。

  CBasePane 執行下列虛擬 Boolean 方法反映這些旗標: CBasePane::CanBeClosed， CBasePane::CanAutoHide， CBasePane::CanFloat。 您可以覆寫這些成員在衍生類別中自訂其行為。

• 您可以透過覆寫 CBasePane::CanAcceptPane自訂的停駐行為。 將防止其他窗格的 窗格中的這個方法會傳回 FALSE 停駐到它。

• 如果您要建立不可以浮動，並防止其他窗格停駐在它前面的靜態窗格 (類似於 OutlookDemo 範例中的 Outlook 功能區)，請建立為非浮動並覆寫 CBasePane::DoesAllowDynInsertBefore 傳回 FALSE。 如果建立窗格，而不用 AFX_CBRS_FLOAT 樣式，預設實作會傳回 FALSE 。

• -1 以外，建立具有 ID 的所有窗格。

• 若要判斷窗格可視性，請使用 CBasePane::IsVisible。 它是以索引標籤和自動隱藏模式正確處理可視性狀態。

• 如果您想要建立非浮動可調整大小的窗格，請建置專案，而不會 AFX_CBRS_FLOAT 樣式並呼叫 CFrameWnd::DockControlBar。

• 從停駐配置排除窗格或從其停駐列移除工具列，請呼叫 CBasePane::UndockPane。 請不要呼叫這個方法窗格中的 [自動隱藏模式或位於索引標籤式視窗索引標籤的 窗格中的。

• 如果您想要取消停駐或浮動在自動隱藏模式的窗格，您必須呼叫 CDockablePane::SetAutoHideMode 和 FALSE ，當第一個引數，在您呼叫 CBasePane::FloatPane 或 CBasePane::UndockPane之前。

範例

下列範例會在 CBasePane 類別會示範如何使用各種方法。 範例會示範如何從 CFrameWndEx 類別擷取窗格以及如何設定停駐窗格模式、對齊和窗格樣式。 程式碼是從 文字填補範例。

            // This CMainFrame class extends the CFrameWndEx class.
            // GetPane is a method in the CFrameWndEx class which 
            // Returns a pointer to the pane that has the specified ID.
            CBasePane* pBar = GetPane(ID_VIEW_FORMATBAR);
            if (pBar != NULL)
            {
                // Set the docking mode, the pane alignment, and the pane style.
                pBar->SetDockingMode(DT_STANDARD);
                pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
                pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
                pBar->ShowPane(TRUE, FALSE, FALSE);
            }

繼承階層架構

CObject

   CCmdTarget

      CWnd

         CBasePane

需求

標題: afxbasepane.h

請參閱

參考

階層架構圖

CBasePane 類別

CWnd 類別

其他資源

MFC 類別