DialogBox

แมโคDialogBoxสร้างกล่องโต้ตอบโมดอลจากทรัพยากรแม่แบบกล่องโต้ตอบ DialogBoxกลับตัวควบคุมจนกว่าฟังก์ชันการเรียกกลับที่ระบุในกล่องโต้ตอบโมดอลที่สิ้นสุดลง โดยการเรียกฟังก์ชันEndDialog แมโคDialogBoxใช้ฟังก์ชันDialogBoxParam.

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

พารามิเตอร์

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

ส่งกลับค่า

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

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

หมายเหตุ

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

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

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

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

QuickInfo

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

ดูเพิ่มเติม

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

Index