共用方式為

CreateMDIWindowA 函式 （winuser.h）

  • 發行項

建立多文檔介面 （MDI） 子視窗。

語法

HWND CreateMDIWindowA(
  [in]           LPCSTR    lpClassName,
  [in]           LPCSTR    lpWindowName,
  [in]           DWORD     dwStyle,
  [in]           int       X,
  [in]           int       Y,
  [in]           int       nWidth,
  [in]           int       nHeight,
  [in, optional] HWND      hWndParent,
  [in, optional] HINSTANCE hInstance,
  [in]           LPARAM    lParam
);

參數

[in] lpClassName

類型：LPCTSTR

MDI 子視窗的視窗類別。 類別名稱必須由呼叫 registerClassEx 函式 來註冊。

[in] lpWindowName

類型：LPCTSTR

視窗名稱。 系統會在子視窗的標題列中顯示名稱。

[in] dwStyle

類型：DWORD

MDI 子視窗的樣式。 如果使用 MDIS_ALLCHILDSTYLES 視窗樣式建立 MDI 用戶端視窗，此參數可以是 視窗樣式 頁面中所列的視窗樣式的任何組合。 否則，此參數會限製為下列一或多個值。

價值 意義
WS_MINIMIZE
0x20000000L
 建立一開始最小化的 MDI 子視窗。
WS_MAXIMIZE
0x01000000L
 建立一開始最大化的 MDI 子視窗。
WS_HSCROLL
0x00100000L
 建立具有水平滾動條的 MDI 子視窗。
WS_VSCROLL
0x00200000L
 建立具有垂直滾動條的 MDI 子視窗。

[in] X

類型：int

MDI 子視窗用戶端座標中的初始水準位置。 如果此參數是 CW_USEDEFAULT （（int）0x80000000），則會將 MDI 子視窗指派為預設水準位置。

[in] Y

類型：int

MDI 子視窗用戶端座標中的初始垂直位置。 如果此參數 CW_USEDEFAULT，則會將 MDI 子視窗指派為預設垂直位置。

[in] nWidth

類型：int

MDI 子視窗的初始寬度，以裝置單位為單位。 如果此參數 CW_USEDEFAULT，則會將 MDI 子視窗指派為預設寬度。

[in] nHeight

類型：int

MDI 子視窗的初始高度，以裝置單位為單位。 如果此參數設定為 CW_USEDEFAULT，則會將 MDI 子視窗指派為預設高度。

[in, optional] hWndParent

類型：HWND

MDI 用戶端視窗的句柄，將成為新 MDI 子視窗的父代。

[in, optional] hInstance

類型：HINSTANCE

建立 MDI 子視窗之應用程式的實例句柄。

[in] lParam

類型：LPARAM

應用程式定義的值。

傳回值

類型：HWND

如果函式成功，傳回值就是所建立視窗的句柄。

如果函式失敗，則傳回值 NULL。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

注意

winuser.h 標頭會將 CreateMDIWindow 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winuser.h （包括 Windows.h）
連結庫 User32.lib
DLL User32.dll

另請參閱

概念

CreateWindow

多個檔介面

參考

RegisterClassEx

WM_MDICREATE