使用多個檔介面
本節說明如何執行下列工作：
為了說明這些工作，本節包含來自 Multipad 的範例，這是 MDI) 應用程式的一般多文檔介面 (。
註冊子視窗和框架視窗類別
典型的 MDI 應用程式必須註冊兩個視窗類別：一個用於其框架視窗，另一個用於其子視窗。 例如，如果應用程式支援一種以上的檔 (，試算表和圖表) ，則必須為每個類型註冊視窗類別。
框架視窗的類別結構類似于非 MDI 應用程式中主視窗的類別結構。 MDI 子視窗的類別結構與非 MDI 應用程式中子視窗的結構稍有不同，如下所示：
- 類別結構應該有圖示，因為使用者可以將 MDI 子視窗最小化，就像是一般應用程式視窗一樣。
- 功能表名稱應該是 Null，因為 MDI 子視窗不能有自己的功能表。
- 類別結構應該在視窗結構中保留額外的空間。 透過此空間，應用程式可以將檔案名之類的資料與特定的子視窗產生關聯。
下列範例示範 Multipad 如何註冊其框架和子視窗類別。
BOOL WINAPI InitializeApplication()
{
WNDCLASS wc;
// Register the frame window class.
wc.style = 0;
wc.lpfnWndProc = (WNDPROC) MPFrameWndProc;
wc.cbClsExtra = 0;
wc.cbWndExtra = 0;
wc.hInstance = hInst;
wc.hIcon = LoadIcon(hInst, IDMULTIPAD);
wc.hCursor = LoadCursor((HANDLE) NULL, IDC_ARROW);
wc.hbrBackground = (HBRUSH) (COLOR_APPWORKSPACE + 1);
wc.lpszMenuName = IDMULTIPAD;
wc.lpszClassName = szFrame;
if (!RegisterClass (&wc) )
return FALSE;
// Register the MDI child window class.
wc.lpfnWndProc = (WNDPROC) MPMDIChildWndProc;
wc.hIcon = LoadIcon(hInst, IDNOTE);
wc.lpszMenuName = (LPCTSTR) NULL;
wc.cbWndExtra = CBWNDEXTRA;
wc.lpszClassName = szChild;
if (!RegisterClass(&wc))
return FALSE;
return TRUE;
}
建立框架和子視窗
註冊視窗類別之後，MDI 應用程式可以建立其視窗。 首先，它會使用 CreateWindow 或 CreateWindowEx 函式來建立框架視窗。 建立框架視窗之後，應用程式會再次使用 CreateWindow 或 CreateWindowEx建立其用戶端視窗。 應用程式應該將 MDICLIENT 指定為用戶端視窗的類別名稱; MDICLIENT 是系統定義的預先註冊視窗類別。 CreateWindow或CreateWindowEx的lpvParam參數應該指向CLIENTCREATESTRUCT結構。 此結構包含下表所述的成員：
| member | 描述 |
|---|---|
| hWindowMenu | 用於控制 MDI 子視窗之視窗功能表的控制碼。 建立子視窗時，應用程式會將其標題新增至視窗功能表做為功能表項目。 然後，使用者可以按一下視窗功能表上的標題來啟動子視窗。 |
| idFirstChild | 指定第一個 MDI 子視窗的識別碼。 第一個建立的 MDI 子視窗會指派此識別碼。 系統會使用遞增的視窗識別碼來建立其他視窗。 當子視窗終結時，系統會立即重新指派視窗識別碼，讓範圍保持連續。 |
將子視窗的標題新增至視窗功能表時，系統會將識別碼指派給子視窗。 當使用者按一下子視窗的標題時，框架視窗會收到 WM_COMMAND 訊息，其中包含 wParam 參數中的識別碼。 您應該為 idFirstChild 成員指定值，該成員不會與框架視窗功能表中的功能表項目識別碼衝突。
多板的框架視窗程式會在處理 WM_CREATE 訊息時建立 MDI 用戶端視窗。 下列範例示範如何建立用戶端視窗。
case WM_CREATE:
{
CLIENTCREATESTRUCT ccs;
// Retrieve the handle to the window menu and assign the
// first child window identifier.
ccs.hWindowMenu = GetSubMenu(GetMenu(hwnd), WINDOWMENU);
ccs.idFirstChild = IDM_WINDOWCHILD;
// Create the MDI client window.
hwndMDIClient = CreateWindow( "MDICLIENT", (LPCTSTR) NULL,
WS_CHILD | WS_CLIPCHILDREN | WS_VSCROLL | WS_HSCROLL,
0, 0, 0, 0, hwnd, (HMENU) 0xCAC, hInst, (LPSTR) &ccs);
ShowWindow(hwndMDIClient, SW_SHOW);
}
break;
子視窗的標題會新增至視窗功能表底部。 如果應用程式使用 AppendMenu 函式將字串新增至視窗功能表，則每當建立或) 終結子視窗時，子視窗的標題就會覆寫這些字串 (。 將字串新增至其視窗功能表的 MDI 應用程式應該使用 InsertMenu 函式，並確認子視窗的標題未覆寫這些新字串。
使用 WS_CLIPCHILDREN 樣式來建立 MDI 用戶端視窗，以防止視窗在其子視窗上繪製。
撰寫主要訊息迴圈
MDI 應用程式的主要訊息迴圈類似于處理快速鍵的非 MDI 應用程式。 差別在於 MDI 訊息迴圈會先呼叫 TranslateMDISysAccel 函式，再檢查應用程式定義的快速鍵，或在分派訊息之前呼叫 TranslateMDISysAccel 函式。
下列範例顯示一般 MDI 應用程式的訊息迴圈。 請注意，如果發生錯誤， GetMessage 可以傳回 -1。
MSG msg;
BOOL bRet;
while ((bRet = GetMessage(&msg, (HWND) NULL, 0, 0)) != 0)
{
if (bRet == -1)
{
// handle the error and possibly exit
}
else
{
if (!TranslateMDISysAccel(hwndMDIClient, &msg) &&
!TranslateAccelerator(hwndFrame, hAccel, &msg))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
}
TranslateMDISysAccel函式會將WM_KEYDOWN訊息轉譯成WM_SYSCOMMAND訊息，並將其傳送至作用中的 MDI 子視窗。 如果訊息不是 MDI 快速鍵訊息，函式會傳回 FALSE，在此情況下，應用程式會使用 TranslateAccelerator 函式來判斷是否按下任何應用程式定義的快速鍵。 如果沒有，迴圈會將訊息分派至適當的視窗程式。
撰寫框架視窗程式
MDI 框架視窗的視窗程式類似于非 MDI 應用程式的主視窗。 差別在於框架視窗程式會將它未處理的所有訊息傳遞給 DefFrameProc 函式，而不是 傳遞給 DefWindowProc 函 式。 此外，框架視窗程式也必須傳遞它所處理的某些訊息，包括下表所列的訊息。
| 訊息 | 回應 |
|---|---|
| WM_COMMAND | 啟動使用者選擇的 MDI 子視窗。 當使用者從 MDI 框架視窗的視窗功能表選擇 MDI 子視窗時，就會傳送此訊息。 此訊息隨附的視窗識別碼會識別要啟動的 MDI 子視窗。 |
| WM_MENUCHAR | 當使用者按下 ALT+ – (減號) 鍵組合時，開啟使用中 MDI 子視窗的視窗功能表。 |
| WM_SETFOCUS | 將鍵盤焦點傳遞至 MDI 用戶端視窗，接著會將它傳遞給作用中的 MDI 子視窗。 |
| WM_SIZE | 調整 MDI 用戶端視窗的大小，以符合新框架視窗的工作區。 如果框架視窗程式將 MDI 用戶端視窗的大小調整為不同的大小，則不應該將訊息傳遞至 DefWindowProc 函 式。 |
Multipad 中的框架視窗程式稱為 MPFrameWndProc。 MPFrameWndProc 處理其他訊息的方式與非 MDI 應用程式類似。 WM_COMMAND Multipad 中的訊息是由本機定義的 CommandHandler 函式處理。 對於命令訊息 Multipad 無法處理，CommandHandler 會呼叫 DefFrameProc 函 式。 如果 Multipad 預設不使用 DefFrameProc ，使用者就無法從視窗功能表啟動子視窗，因為按一下視窗的功能表項目所傳送 的WM_COMMAND 訊息將會遺失。
撰寫子視窗程式
如同框架視窗程式，MDI 子視窗程式預設會使用特殊函式來處理訊息。 子視窗程式未處理的所有訊息都必須傳遞至 DefMDIChildProc 函式，而不是 DefWindowProc 函 式。 此外，某些視窗管理訊息必須傳遞至 DefMDIChildProc，即使應用程式處理訊息，MDI 才能正常運作。 以下是應用程式必須傳遞至 DefMDIChildProc 的訊息。
| 訊息 | 回應 |
|---|---|
| WM_CHILDACTI加值稅E | 當 MDI 子視窗的大小、移動或顯示時，執行啟用處理。 必須傳遞此訊息。 |
| WM_GETMINMAXINFO | 根據 MDI 用戶端視窗的目前大小，計算最大化 MDI 子視窗的大小。 |
| WM_MENUCHAR | 將訊息傳遞至 MDI 框架視窗。 |
| WM_MOVE | 如果 MDI 用戶端捲軸存在，請重新計算它們。 |
| WM_SETFOCUS | 如果子視窗不是使用中的 MDI 子視窗，則會啟動子視窗。 |
| WM_SIZE | 執行變更視窗大小所需的作業，特別是用於最大化或還原 MDI 子視窗。 無法將此訊息傳遞至 DefMDIChildProc 函式會產生高度不想要的結果。 |
| WM_SYSCOMMAND | 處理先前稱為系統) 功能表命令的視窗 (： SC_NEXTWINDOW、 SC_PREVWINDOW、 SC_MOVE、 SC_SIZE和 SC_MAXIMIZE。 |
建立子視窗
若要建立 MDI 子視窗，應用程式可以呼叫 CreateMDIWindow 函式，或將 WM_MDICREATE 訊息傳送至 MDI 用戶端視窗。 (應用程式可以使用 CreateWindowEx 函式搭配 WS_EX_MDICHILD 樣式來建立 MDI 子視窗.) 單線程 MDI 應用程式可以使用任一方法來建立子視窗。 多執行緒 MDI 應用程式中的執行緒必須使用 CreateMDIWindow 或 CreateWindowEx 函式，在不同的執行緒中建立子視窗。
WM_MDICREATE訊息的lParam參數是MDICREATESTRUCT結構的遠指標。 結構包含四個維度成員： x 和 y，表示視窗的水準和垂直位置，而 cx 和 cy則表示視窗的水準和垂直範圍。 這些成員可由應用程式明確指派，或者可能會設定為 CW_USEDEFAULT，在此情況下，系統會根據串聯演算法選取位置、大小或兩者。 在任何情況下，都必須初始化所有四個成員。 多板會針對所有維度使用 CW_USEDEFAULT 。
MDICREATESTRUCT結構的最後一個成員是樣式成員，其可能包含視窗的樣式位。 若要建立可具有任意視窗樣式組合的 MDI 子視窗，請指定 MDIS_ALLCHILDSTYLES 視窗樣式。 未指定此樣式時，MDI 子視窗具有 WS_MINIMIZE、 WS_MAXIMIZE、 WS_HSCROLL和 WS_VSCROLL 樣式作為預設設定。
Multipad 會使用本機定義的 AddFile 函式建立其 MDI 子視窗， (位於來源檔案 MPFILE 中。C) 。 AddFile 函式會將視窗MDICREATESTRUCT結構的szTitle成員指派給要編輯的檔案名或 「Untitled」 來設定子視窗的標題。szClass成員會設定為在 Multipad 的 InitializeApplication 函式中註冊的 MDI 子視窗類別名稱。 hOwner成員會設定為應用程式的實例控制碼。
下列範例顯示 Multipad 中的 AddFile 函式。
HWND APIENTRY AddFile(pName)
TCHAR * pName;
{
HWND hwnd;
TCHAR sz[160];
MDICREATESTRUCT mcs;
if (!pName)
{
// If the pName parameter is NULL, load the "Untitled"
// string from the STRINGTABLE resource and set the szTitle
// member of MDICREATESTRUCT.
LoadString(hInst, IDS_UNTITLED, sz, sizeof(sz)/sizeof(TCHAR));
mcs.szTitle = (LPCTSTR) sz;
}
else
// Title the window with the full path and filename,
// obtained by calling the OpenFile function with the
// OF_PARSE flag, which is called before AddFile().
mcs.szTitle = of.szPathName;
mcs.szClass = szChild;
mcs.hOwner = hInst;
// Use the default size for the child window.
mcs.x = mcs.cx = CW_USEDEFAULT;
mcs.y = mcs.cy = CW_USEDEFAULT;
// Give the child window the default style. The styleDefault
// variable is defined in MULTIPAD.C.
mcs.style = styleDefault;
// Tell the MDI client window to create the child window.
hwnd = (HWND) SendMessage (hwndMDIClient, WM_MDICREATE, 0,
(LONG) (LPMDICREATESTRUCT) &mcs);
// If the file is found, read its contents into the child
// window's client area.
if (pName)
{
if (!LoadFile(hwnd, pName))
{
// Cannot load the file; close the window.
SendMessage(hwndMDIClient, WM_MDIDESTROY,
(DWORD) hwnd, 0L);
}
}
return hwnd;
}
在WM_MDICREATE訊息的lParam參數中傳遞的指標會傳遞至CreateWindow函式，並顯示為CREATESTRUCT結構中的第一個成員，並傳入WM_CREATE訊息。 在 Multipad 中，子視窗會在 WM_CREATE 訊息處理期間初始化本身，方法是在其額外資料中初始化檔變數，以及建立編輯控制項的子視窗。