DlgDirList

ฟังก์ชันDlgDirListเติมกล่องรายการที่ระบุ ด้วยชื่อของแฟ้มทั้งหมดที่ตรงกับที่ระบุเส้นทางหรือชื่อแฟ้ม.

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

พารามิเตอร์

hDlg

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

lpPathSpec

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

nIDListBox

ระบุรหัสของกล่องรายการ ถ้าพารามิเตอร์นี้เป็นศูนย์DlgDirListถือว่า ไม่มีกล่องรายการอยู่ และไม่พยายามที่จะกรอกข้อมูลอย่างใดอย่างหนึ่ง.

nIDStaticPath

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

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.

หมายเหตุ

ถ้าคุณระบุสายอักขระความยาวเป็นศูนย์สำหรับพารามิเตอร์lpPathSpecหรือสายอักขระจะเปลี่ยนไปถ้าคุณได้ระบุชื่อไดเรกทอรีเท่ากับไม่มีชื่อแฟ้ม * *

พารามิเตอร์lpPathSpecมีแบบฟอร์มต่อไปนี้:

[ไดรฟ์:] [[\u]ไดเรกทอรี[\iไดเรกทอรี] \u] [filename]

ในตัวอย่างนี้ไดรฟ์คือ ตัวอักษรของไดรฟ์ ชื่อไดเรกทอรีที่ถูกต้องคือไดเรกทอรีและชื่อแฟ้มเป็นชื่อแฟ้มถูกต้องที่ต้องประกอบด้วยอย่างน้อยหนึ่งตัวแทน (? หรือ *).

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

หลังจากที่มีเติมกล่องรายการDlgDirListอัพเดlpPathSpecโดยการเอาไดรฟ์ หรือไดเรกทอรีส่วน หรือทั้งสอง อย่าง เส้นทางและชื่อแฟ้ม.

DlgDirListส่งข้อความ LB_RESETCONTENT และ LB_DIR ไปยังกล่องรายการ.

QuickInfo

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

ดูเพิ่มเติม

ภาพรวมของกล่องรายการรายการกล่องฟังก์ชัน DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index