DlgDirListComboBox

ฟังก์ชันDlgDirListComboBoxจะกรอกข้อมูลกล่องคำสั่งผสมที่ระบุกับรายการไดเรกทอรี โปรแกรมกรอกในรายการกับชื่อของแฟ้มทั้งหมด ไดรฟ์ และ subdirectories ที่ตรงกับแอตทริบิวต์ที่ระบุและเส้นทางสาย.

int DlgDirListComboBox ( HWND  hDlg, / / จัดการกับกล่องโต้ตอบกับกล่องคำสั่งผสมLPTSTRlpPathSpec, / / ชี้ไปยังสายเส้นทางหรือชื่อแฟ้มintnIDComboBox, / / ตัวบ่งชี้ของกล่องคำสั่งผสมintnIDStaticPath, / / รหัสของตัวควบคุมแบบสแตติกUINTuFiletype / / แฟ้มแอตทริบิวต์การแสดง);
 

พารามิเตอร์

hDlg

จัดการกับกล่องโต้ตอบที่ประกอบด้วยกล่องคำสั่งผสม.

lpPathSpec

ชี้เพื่อหยุดการทำงานเป็น null สายอักขระของแบบฟอร์มต่อไปนี้:

[drive:][\]][ไดเรกทอรี\[...]][filename]

ถ้ามีสายอักขระที่ระบุในไดรฟ์ หรือเส้นทางไดเรกทอรี ฟังก์ชันDlgDirListComboBoxจะ เปลี่ยนไดรฟ์ปัจจุบันและไดเรกทอรีที่ก่อนทำการกรอกข้อมูลในรายการ หลังจากที่มีเติมรายการ เส้นทางไดรฟ์และไดเรกทอรีจะถูกเอาออกจากสายอักขระที่ระบุ โดยพารามิเตอร์lpPathSpec.

nIDComboBox

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

nIDStaticPath

ระบุรหัสของตัวควบคุมข้อความแบบคงที่ซึ่งฟังก์ชันDlgDirListComboBoxจะเป็นเพื่อ แสดงไดเรกทอรีปัจจุบัน ถ้าnIDStaticPathไม่ศูนย์DlgDirListComboBoxถือว่า ไม่มีการควบคุมเช่นทำงานอยู่.

uFiletype

ระบุคุณลักษณะของแฟ้มจะแสดงขึ้น มันสามารถเป็นการรวมกันของค่าต่อไปนี้:

ค่า	ความหมาย
DDL_ARCHIVE	ประกอบด้วยแฟ้มที่ถูกเก็บถาวร.
DDL_DIRECTORY	รวมถึง subdirectories ชื่อไดเรกทอรีย่อยจะอยู่ในเครื่องหมายวงเล็บเหลี่ยม ([]).
DDL_DRIVES	มีไดรฟ์ ไดรฟ์อยู่ในแบบฟอร์ม [-x-], โดยที่xคืออักษรระบุไดรฟ์.
DDL_EXCLUSIVE	รวมเฉพาะแฟ้มที่ มีแอตทริบิวต์ที่ระบุ โดยค่าเริ่มต้น อ่าน-เขียนแฟ้มอยู่แม้ว่าจะไม่มีระบุ DDL_READWRITE.
DDL_HIDDEN	ประกอบด้วยแฟ้มที่ซ่อนไว้.
DDL_READONLY	ประกอบด้วยแฟ้มแบบอ่านอย่างเดียว.
DDL_READWRITE	อ่าน-เขียนแฟ้ม includes ที่ มีไม่มีแอตทริบิวต์เพิ่มเติม.
DDL_SYSTEM	รวมถึงระบบแฟ้ม.
DDL_POSTMSGS	ลงข้อความไปยังคิวข้อความของโปรแกรมประยุกต์ โดยค่าเริ่มต้น ฟังก์ชันDlgDirListส่งข้อความโดยตรงกับขั้นตอนในกล่องโต้ตอบ.

ส่งกลับค่า

ถ้าฟังก์ชันสำเร็จ ค่าส่งกลับจะไม่ใช่ศูนย์.

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

หมายเหตุ

ถ้าพารามิเตอร์lpszPathSpecชี้สตริงที่มีความยาวเป็นศูนย์ หรือสายอักขระที่ระบุในไดรฟ์ ไดเรกทอรี หรือทั้งสองอย่าง — แต่ไม่มีชื่อแฟ้ม — ชื่อแฟ้ม * * (อักขระตัวแทน) จะถือว่า.

Windows NT:

รายชื่อไดเรกทอรีที่แสดงชื่อแฟ้มที่ยาว ถ้ามี.

Windows 95:

รายชื่อไดเรกทอรีที่แสดงชื่อแฟ้มแบบสั้น (แบบฟอร์ม 8.3) คุณสามารถใช้ฟังก์ชันSHGetFileInfoหรือGetFullPathNameเพื่อรับชื่อแฟ้มยาวนานที่สอดคล้องกัน.

QuickInfo

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

ดูเพิ่มเติม

ภาพรวมของกล่องคำสั่งผสมกล่องคำสั่งผสมฟังก์ชัน DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Index