使用多個檔介面

發行項
06/13/2023

本節說明如何執行下列工作：

註冊子視窗和框架視窗類別
建立框架和子視窗
撰寫主要訊息迴圈
撰寫框架視窗程式
撰寫子視窗程式
建立子視窗

為了說明這些工作，本節包含來自 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 訊息處理期間初始化本身，方法是在其額外資料中初始化檔變數，以及建立編輯控制項的子視窗。