GetOpenFileName

ฟังก์ชันGetOpenFileNameสร้างการทั่วไปกล่องโต้ตอบเปิดที่อนุญาตให้ผู้ใช้ระบุไดรฟ์ directory และชื่อของแฟ้มหรือชุดของแฟ้มเพื่อเปิด.

(BOOL GetOpenFileName LPOPENFILENAME  lpofn / / ที่อยู่ของโครงสร้างที่มีการเตรียมใช้งาน / / ข้อมูล);
 

พารามิเตอร์

lpofn
ชี้ไปโครงสร้างของOPENFILENAMEที่ประกอบด้วยข้อมูลที่ใช้ในการเริ่มต้นกล่องโต้ตอบ เมื่อGetOpenFileNameส่งกลับ โครงสร้างนี้ประกอบด้วยข้อมูลเกี่ยวกับการเลือกแฟ้มของผู้ใช้.

ส่งกลับค่า

ถ้าผู้ใช้ระบุชื่อแฟ้ม และคลิกปุ่มOKค่าส่งกลับจะไม่ใช่ศูนย์ บัฟเฟอร์ที่ชี้ไป โดยสมาชิกlpstrFileของโครงสร้างOPENFILENAMEไม่ประกอบด้วยพาธเต็มและชื่อแฟ้มที่ระบุ โดยผู้ใช้.

ถ้าผู้ใช้ยกเลิก หรือปิดกล่องโต้ตอบเปิดหรือมีข้อผิดพลาดเกิดขึ้น ค่าส่งกลับเป็นศูนย์ การรับข้อมูลความผิดพลาดแบบขยาย เรียกใช้ฟังก์ชันCommDlgExtendedErrorซึ่งสามารถส่งกลับหนึ่งในค่าต่อไปนี้:

CDERR_FINDRESFAILURE CDERR_NOHINSTANCE
CDERR_INITIALIZATION CDERR_NOHOOK
CDERR_LOCKRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADRESFAILURE CDERR_STRUCTSIZE
CDERR_LOADSTRFAILURE FNERR_BUFFERTOOSMALL
CDERR_MEMALLOCFAILURE FNERR_INVALIDFILENAME
CDERR_MEMLOCKFAILURE FNERR_SUBCLASSFAILURE

หมายเหตุ

เริ่มต้น ด้วย Windows 95 และ Windows NT 4.0 รุ่น กล่องโต้ตอบเริ่มต้นเปิดแสดงคุณลักษณะของอินเทอร์เฟซสำหรับผู้ใช้ที่คล้ายกับ Windows Explorer คุณสามารถจัดเป็นขั้นตอนของ hook OFNHookProcสำหรับกล่องโต้ตอบที่มีลักษณะ Explorerเปิด เมื่อต้องการเปิดการใช้งานในขั้นตอนของ hook ตั้งค่าสถานะ OFN_EXPLORER และ OFN_ENABLEHOOK ในสถานะสมาชิกของโครงสร้างOPENFILENAMEและระบุอยู่ของขั้นตอนของ hook ในสมาชิกlpfnHook.

Windows 95 และ Windows NT ยังสนับสนุนการแบบกล่องโต้ตอบเปิดสำหรับโปรแกรมประยุกต์ที่ต้องการรักษาแบบส่วนติดต่อผู้ใช้ที่สอดคล้องกับ Windows 3.1 หรือส่วนติดต่อผู้ใช้ของ Windows NT 3.51 เมื่อต้องการแสดงในแบบกล่องโต้ตอบเปิดการเปิดใช้งานเป็นขั้นตอนของ hook OFNHookProcOldStyleและให้แน่ใจว่า ไม่ตั้งค่าสถานะ OFN_EXPLORER.

เมื่อต้องการแสดงกล่องโต้ตอบที่อนุญาตให้ผู้ใช้สามารถเลือกไดเรกทอรีแทนของแฟ้ม เรียกการ SHBrowseForFolderฟังก์ชัน.

Windows CE: โครงสร้างOPENFILENAMEสมาชิกทั้งหมดไม่มีกำหนดใน Windows CE สำหรับข้อมูลเกี่ยวกับการกำหนดสมาชิก ดูหัวข้ออ้างอิงสำหรับโครงสร้างOPENFILENAME.

QuickInfo

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

ดูเพิ่มเติม

ภาพรวมไลบรารีของกล่องโต้ตอบทั่วไปฟังก์ชันของกล่องโต้ตอบทั่วไป CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME, SHBrowseForFolder

Index