DlgDirListComboBox

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

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

פרמטרים

hDlg

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

lpPathSpec

המצביע למחרוזת המסתיימת ב- null בצורה הבאה:

[drive:][\]][מדריך\[...]][שם הקובץ]

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

nIDComboBox

קביעת המזהה של פקד תיבה משולבת בתיבת דו-שיח. אם nIDComboBox הוא אפס, הפונקציה DlgDirListComboBox מניח תיבה משולבת לא קיים וכי אינו מנסה למלא אותו.

nIDStaticPath

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

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.

הערות

אם הפרמטר lpszPathSpec מצביע למחרוזת באורך אפס או מחרוזת המציין כונן, מדריך כתובות או שניהם — אך לא שם קובץ — שם הקובץ *. * ההנחה (תווים כלליים).

Windows NT:

מפירוט הספריה מציגה שמות קבצים ארוכים, אם בכלל.

Windows 95:

מפירוט הספריה מציגה שמות קבצים קצרים (טופס 8.3). באפשרותך להשתמש בפונקציות SHGetFileInfo או GetFullPathName כדי לקבל את שם הקובץ ארוך המתאים.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.

ראה גם

מבט כולל על תיבות משולבות, התיבה המשולבת אינה מתפקדת, DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Index