DialogBoxParam

ฟังก์ชันDialogBoxParamสร้างกล่องโต้ตอบโมดอลจากทรัพยากรแม่แบบกล่องโต้ตอบ ก่อนที่จะแสดงในกล่องโต้ตอบ ฟังก์ชันส่งค่ากำหนดโดยโปรแกรมประยุกต์ลงในกระบวนงานของกล่องโต้ตอบเป็นพารามิเตอร์ของความWM_INITDIALOG lParam โปรแกรมประยุกต์ที่สามารถใช้ค่านี้ในการเตรียมใช้งานตัวควบคุมกล่องโต้ตอบ.

int DialogBoxParam ( HINSTANCE  hInstance, / / จัดการกับอินสแตนซ์ของแอพลิเคชันLPCTSTRlpTemplateName, / / ระบุแม่แบบกล่องโต้ตอบHWNDhWndParent, / / จัดการเจ้าของหน้าต่างDLGPROClpDialogFunc, / / ชี้เพื่อโต้ตอบกล่องกระบวนงานLPARAMdwInitParam / / ค่าเริ่มต้น);
 

พารามิเตอร์

hInstance
อินสแตนซ์ของโมดูแฟ้มปฏิบัติการได้ประกอบด้วยแม่แบบกล่องโต้ตอบที่ระบุ.
lpTemplateName
ระบุแม่แบบกล่องโต้ตอบ พารามิเตอร์นี้เป็นตัวชี้การเป็นสายอักขระที่สิ้นสุดด้วยค่า null ที่ระบุชื่อของแม่แบบกล่องโต้ตอบหรือใช้ค่าจำนวนเต็มที่ระบุตัวระบุทรัพยากรของต้นแบบกล่องโต้ตอบ อย่างใดอย่างหนึ่ง ถ้าพารามิเตอร์ระบุตัวระบุทรัพยากร คำสูงใบสั่งต้องเป็นศูนย์ และคำต่ำใบสั่งต้องประกอบด้วยตัวระบุ คุณสามารถใช้แมโคMAKEINTRESOURCEเพื่อสร้างค่านี้.
hWndParent
ระบุหน้าต่างที่เป็นเจ้าของกล่องโต้ตอบ.
lpDialogFunc
ชี้ไปยังขั้นตอนในกล่องโต้ตอบ ดูข้อมูลเพิ่มเติมเกี่ยวกับขั้นตอนในกล่องโต้ตอบ DialogProc.
dwInitParam
ระบุค่าที่จะส่งผ่านไปยังกล่องโต้ตอบพารามิเตอร์lParamของข้อความ WM_INITDIALOG.

ส่งกลับค่า

ถ้าฟังก์ชันสำเร็จ ค่าส่งกลับเป็นค่าที่ระบุในการโทรไปยังฟังก์ชันEndDialogที่ใช้ในการยกเลิกกล่องโต้ตอบพารามิเตอร์nResult.

ถ้าฟังก์ชันล้มเหลว ค่าส่งกลับเป็น– 1 การขอเพิ่มเติมข้อมูลข้อผิดพลาด โทร GetLastError.

หมายเหตุ

ฟังก์ชันDialogBoxParamใช้ฟังก์ชันCreateWindowExเพื่อสร้างกล่องโต้ตอบ DialogBoxParamแล้วส่งข้อความ WM_INITDIALOG (และข้อความ WM_SETFONT) ถ้าแม่แบบระบุลักษณะ DS_SETFONT ลงในกระบวนงานของกล่องโต้ตอบ ฟังก์ชันจะแสดงกล่องโต้ตอบ (คำนึงว่าแม่แบบระบุลักษณะ WS_VISIBLE), เจ้าของหน้าต่างที่ปิดใช้งาน และเริ่มวนรอบข้อความของตัวเองในการรับ และส่งข้อความสำหรับกล่องโต้ตอบ.

เมื่อขั้นตอนในกล่องโต้ตอบเรียกฟังก์ชันEndDialog , DialogBoxParamกล่องโต้ตอบขัด สิ้นสุดการวนรอบข้อความ ช่วยให้เจ้าของหน้าต่าง (ถ้าเคย เปิดใช้งาน), และส่งกลับค่าของพารามิเตอร์nResultที่ระบุ โดยขั้นตอนในกล่องโต้ตอบเมื่อนั้นเรียกว่าEndDialog.

Windows 95 และรุ่นที่ใหม่กว่า:ระบบสามารถรองรับได้สูงสุด 255 ตัวควบคุมต่อแม่แบบกล่องโต้ตอบ เมื่อต้องการวางตัวควบคุมที่มากกว่า 255 ในกล่องโต้ตอบ สร้างตัวควบคุมในตัวจัดการข้อความ WM_INITDIALOG แทนที่ใส่ในแม่แบบ.

Windows CE: ลักษณะทั้งหมดที่ไม่ได้รับการสนับสนุนในโครงสร้างในต้นแบบการโต้ตอบการอ้างอิง โดยพารามิเตอร์lpTemplateName . DLGTEMPLATE

QuickInfo

nbsp Windows &NT:ต้องการเวอร์ชัน 3.1 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ต้องการเวอร์ชัน 1.0 หรือรุ่นใหม่กว่า
หัวข้อ:ประกาศใน winuser.h
ไลบรารีที่นำเข้า:ใช้ user32.lib
Unicode:นำมาใช้เป็น Unicode และ ANSI รุ่นบน Windows NT.

ดูเพิ่มเติม

ภาพรวมของกล่องโต้ตอบฟังก์ชันของกล่องโต้ตอบ CreateWindowEx, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

Index