TN029：分隔視窗

發行項
10/12/2023

此附注描述 MFC CSplitterWnd 類別，該類別提供視窗分割和管理其他窗格視窗的大小調整。

分隔器樣式

支援 CSplitterWnd 兩種不同的分割視窗樣式。

在「靜態分隔器」中，分割器視窗會在建立時建立窗格。窗格的順序和數目永遠不會變更。分隔列可用來調整不同窗格的大小。您可以使用此樣式在每個窗格中顯示不同的檢視類別。 Visual C++ 圖形編輯器和 Windows 檔案管理員是使用此分隔器樣式的程式範例。此分隔視窗樣式不會使用分隔器方塊。

在「動態分割器」中，當使用者分割和取消分割新檢視時，會建立並終結其他窗格。這個分割器會從單一檢視開始，並提供分隔器方塊，讓使用者起始分割。當檢視以單一方向分割時，分割器視窗會動態建立新的檢視物件。這個新的檢視物件代表新的窗格。如果使用鍵盤介面將檢視分割成兩個方向，則分割器視窗會為三個新的窗格建立三個新的檢視物件。當分割作用中時，Windows 會將分割器方塊顯示為窗格之間的分隔列。當使用者移除分割時，Windows 會終結其他檢視物件，但原始檢視會維持在分割器視窗本身終結之前。 Microsoft Excel 和 Microsoft Word 是使用動態分隔器樣式的應用程式範例。

當您建立任一種分割器視窗時，您必須指定分割器將管理的資料列和資料行數目上限。靜態分隔器會建立窗格來填滿所有資料列和資料行。動態分隔器只會在建立時 CSplitterWnd 建立第一個窗格。

您可以為靜態分割器指定的窗格數目上限是 16 個數據行的 16 個數據列。建議的組態如下：

1 列 x 2 欄：通常具有不同的窗格
2 個數據列 x 1 欄：通常具有不同的窗格
2 個數據列 x 2 個數據行：通常具有類似的窗格

您可以為動態分割器指定的窗格數目上限是 2 個數據列乘 2 個數據行。建議的組態如下：

1 列 x 2 個數據行：適用于單欄資料
2 列 x 1 欄：適用于文字或其他資料
2 個數據列 x 2 個數據行：適用于方格或資料表導向的資料

分割器範例

許多 MFC 範例程式會直接或間接使用分割器視窗。 MFC 一般範例 VIEWEX 說明數種靜態分割器的用法，包括如何將分割器放在分割器中。

您也可以使用 ClassWizard 來建立新的多文檔介面（MDI）子框架視窗類別，其中包含分割器視窗。如需分割器視窗的詳細資訊，請參閱多個檔案類型、檢視和框架視窗。

實作所使用的術語

以下是分割器視窗特有的字詞清單：

CSplitterWnd：提供窗格分割控制項和捲軸的視窗，可在資料列或資料行上的所有窗格之間共用。您可以指定以零起始數位的資料列和資料行（第一個窗格是 row = 0，而資料行 = 0）。

窗格：管理的應用程式特定視窗 CSplitterWnd 。窗格通常是衍生自 CView 類別的物件，但可以是任何具有適當子視窗識別碼的 CWnd 物件。

若要使用 CWnd 衍生物件，請將物件的RUNTIME_CLASS傳遞至 CreateView 函式，就像您使用衍生類別一 CView 樣。您的類別必須使用 DECLARE_DYNCREATE 和 IMPLEMENT_DYNCREATE，因為架構會在執行時間使用動態建立。雖然中 CSplitterWnd 有許多專屬 CView 于類別的程式碼，但在執行這些動作之前，一律會使用 CObject：：IsKindOf 。

分隔列：在窗格的資料列和資料行之間放置的控制項。它可以用來調整窗格的資料列或資料行大小。

分割器方塊：動態 CSplitterWnd 中的控制項，可用來建立窗格的新資料列或欄。它位於垂直捲動條頂端或水準捲軸左邊。

分隔器交集：垂直分隔列和水準分隔列的交集。您可以拖曳它，以同時調整窗格的資料列和資料行大小。

共用捲軸

類別 CSplitterWnd 也支援共用捲軸。這些捲軸控制項是的 CSplitterWnd 子系，並與分隔器中的不同窗格共用。

例如，在 1 列 x 2 資料行視窗中，您可以在建立 CSplitterWnd 時指定WS_VSCROLL。 Windows 會建立在兩個窗格之間共用的特殊捲軸控制項。

[      ][      ][^]
[pane00][pane01][|]
[      ][      ][v]

當使用者移動捲軸時，WM_VSCROLL訊息會傳送至這兩個檢視。當任一個檢視設定捲軸位置時，將會設定共用捲軸。

請注意，共用捲軸對類似的檢視物件最有用。如果您在分割器中混合不同類型的檢視，您可能必須撰寫特殊的程式碼來協調其捲動位置。任何 CView 使用捲軸 API 的 CWnd 衍生類別，如果共用捲軸存在，則會委派給共用捲軸。實作 CScrollView 是支援共用捲軸之類別的其中一個 CView 範例。不是衍生自 CView 的類別、依賴非控制捲軸的類別，或是使用標準 Windows 實作的類別（例如， CEditView ）將無法使用的共用捲軸功能 CSplitterWnd 。

最小大小

每個資料列都有最小資料列高度，而每個資料行的欄寬下限。此最小保證窗格不會太小，無法完整顯示。

如果是靜態分隔器視窗，初始最小資料列高度和資料行寬度為 0。對於動態分隔器視窗，初始最小資料列高度和資料行寬度是由 函式的 sizeMin 參數 CSplitterWnd::Create 所設定。

您可以使用 CSplitterWnd：：SetRowInfo 和 CSplitterWnd：：SetColumnInfo 函式來變更這些最小大小。

實際大小與理想大小

分割器視窗中窗格的配置取決於包含窗格的框架大小。當使用者調整包含框架的大小時， CSplitterWnd 重新調整和調整窗格的大小，使其盡可能適合。

使用者可以手動設定資料列高度和資料行寬度大小，或者程式可以使用類別來設定理想的大小 CSplitterWnd 。實際大小可以小於或大於理想。如果沒有足夠的空間可顯示理想的大小，或分割器視窗右側或底部有太多空白空間，Windows 將會調整實際大小。

自訂控制項

您可以覆寫許多函式，以提供自訂的行為和自訂介面。您可以覆寫此第一個集合，為分割器視窗的各種圖形元件提供替代影像。

virtual void OnDrawSpltter(CDC* pDC, ESplitType nType, const CRect& rect);
virtual void OnInvertTracker(const CRect& rect);

您可以呼叫此函式來建立共用捲軸控制項。您可以覆寫它，以在捲軸旁建立額外的控制項。

virtual BOOL CreateScrollBarCtrl(DWORD dwStyle, UINT nID);

這些函式會實作動態分隔器視窗的邏輯。您可以覆寫這些來提供更進階的分割器邏輯。

virtual void DeleteView(int row, int col);
virtual BOOL SplitRow(int cyBefore);
virtual BOOL SplitColumn(int cxBefore);
virtual void DeleteRow(int rowDelete);
virtual void DeleteColumn(int colDelete);

CView 功能

類別 CView 會使用下列高階命令來委派至實作 CSplitterWnd 。因為這些命令是虛擬的，因此標準 CView 實作不需要連結整個 CSplitterWnd 實作。對於使用 CView 但不是 CSplitterWnd 的應用程式，實 CSplitterWnd 作將不會與應用程式連結。

virtual BOOL CanActivateNext(BOOL bPrev = FALSE);

檢查目前是否可能ID_NEXT_PANE或ID_PREV_PANE。
virtual void ActivateNext(BOOL bPrev = FALSE);

執行 [下一個窗格] 或 [上一個窗格] 命令。
virtual BOOL DoKeyboardSplit();

執行鍵盤分割命令，通常是「視窗分割」。

另請參閱

依編號顯示的技術提示
 依分類區分的技術提示

Share via