createMDIWindowA 函式 (winuser.h)

發行項
03/04/2024

(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 [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll