共用方式為


DialogBoxA 宏 (winuser.h)

從對話框範本資源建立強制響應對話方塊。 在指定的回呼函式呼叫 EndDialog 函式來終止強制回應對話方塊之前,DialogBox 不會傳回控件。

DialogBox 會實作為 DialogBoxParam 函式的呼叫。

語法

void DialogBoxA(
  [in, optional]  hInstance,
  [in]            lpTemplate,
  [in, optional]  hWndParent,
  [in, optional]  lpDialogFunc
);

參數

[in, optional] hInstance

類型: HINSTANCE

包含對話框範本之模組的句柄。 如果此參數為 NULL,則會使用目前的可執行檔。

[in] lpTemplate

類型: LPCTSTR

對話框範本。 這個參數是指定對話框範本名稱的 Null 終止字元字串指標,或是指定對話框範本之資源識別碼的整數值。 如果參數指定資源標識符,則其高序字必須是零,而且其低序字必須包含標識符。 您可以使用 MAKEINTRESOURCE 宏來建立此值。

[in, optional] hWndParent

類型: HWND

擁有對話框之視窗的句柄。

[in, optional] lpDialogFunc

類型: DLGPROC

對話框程式的指標。 如需對話框程式的詳細資訊,請參閱 DialogProc

傳回值

備註

DialogBox 宏會使用 CreateWindowEx 函式來建立對話框。 如果範本指定對話框程式DS_SETFONT或DS_SHELLFONT) 樣式,DialogBox 接著會傳送WM_INITDIALOG訊息 (和WM_SETFONT訊息。 函式會顯示對話框 (不論範本是否指定 WS_VISIBLE 樣式) 、停用擁有者視窗,以及啟動自己的訊息循環來擷取和分派對話框的訊息。

當對話框過程呼叫 EndDialog 函式時,DialogBox 會終結對話框、結束訊息迴圈、如果先前啟用) ,則會啟用擁有者視窗 (,並在呼叫 EndDialog 時傳回對話框程式指定的 nResult 參數。

範例

如需範例,請參閱 建立強制響應對話方塊

注意

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

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll

另請參閱

概念

CreateDialog

CreateWindowEx

對話框

DialogBoxIndirect

DialogBoxIndirectParam

DialogBoxParam

DialogProc

EndDialog

MAKEINTRESOURCE

參考

WM_INITDIALOG

WM_SETFONT