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