DlgDirList

הפונקציה DlgDirList ממלא את תיבת הרשימה שצוין עם השמות של כל הקבצים התואמים את הנתיב שצוין או שם קובץ.

int DlgDirList ( HWND  hDlg, / / לטפל בתיבת הדו-שיח עם תיבת רשימהLPTSTRlpPathSpec, / / המצביע למחרוזת נתיב או שם קובץintnIDListBox, / / המזהה של תיבת רשימהintnIDStaticPath, / / המזהה של הפקד סטטיUINTuFileType / / תכונות כדי להציג קובץ);
 

פרמטרים

hDlg

לטפל אל תיבת הדו-שיח המכילה את תיבת הרשימה.

lpPathSpec

מצביע מחרוזת המסתיימת ב- null המכילה את הנתיב או את שם הקובץ. DlgDirList משנה מחרוזת זו, צריך להיות ארוך מספיק כדי להכיל את השינויים. לקבלת מידע נוסף אודות פרמטר זה, עיין בסעיף הערות.

nIDListBox

מציין את המזהה של תיבת רשימה. אם פרמטר זה הוא אפס, DlgDirList מניח כי אין תיבת רשימה קיים וכי אינו מנסה למלא אחד.

nIDStaticPath

מציין את המזהה של הפקד סטטי המשמש להצגת את הכונן והספריה הנוכחיים. אם פרמטר זה הוא אפס, DlgDirList מבוסס על ההנחה כי אין שליטה כזה קיים.

uFileType

ציון תכונות של שמות הקבצים שיש להציג. פרמטר זה חייב להיות אחד או יותר מהבאים:

ערך	תיאור
DDL_ARCHIVE	כולל קבצים בארכיון.
DDL_DIRECTORY	כולל ספריות משנה. השמות של ספריות המשנה מוקפים בסוגריים מרובעים ([]).
DDL_DRIVES	כולל כוננים. כוננים מפורטים בטופס [-x-], כאשר x מהווה אות הכונן.
DDL_EXCLUSIVE	כולל קבצים עם התכונות שצוינו בלבד. כברירת מחדל, קבצים לקריאה/כתיבה רשומים גם אם לא צוין DDL_READWRITE.
DDL_HIDDEN	כולל קבצים מוסתרים.
DDL_READONLY	כולל קבצים לקריאה בלבד.
DDL_READWRITE	כולל קריאה-כתיבה לקבצים ללא תכונות נוספות.
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 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.

ראה גם

מבט כולל על תיבות רשימה, פונקציות בתיבת רשימה, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index