GetSaveFileName

הפונקציה GetSaveFileName יוצרת לשמור נפוצות תיבת דו-שיח המאפשרת למשתמש לציין את הכונן, הספריה ואת שם קובץ לשמירת.

(BOOL GetSaveFileName LPOPENFILENAME  lpofn / / כתובת של מבנה עם אתחול / / נתונים);
 

פרמטרים

lpofn
מצביע למבנה הפרמטר OPENFILENAME המכיל מידע המשמש כדי לאתחל את תיבת הדו-שיח. כאשר חוזר GetSaveFileName , מבנה זה מכיל מידע אודות בחירת קובץ של המשתמש.

להחזיר ערכים

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

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

CDERR_FINDRESFAILURE CDERR_NOHINSTANCE
CDERR_INITIALIZATION CDERR_NOHOOK
CDERR_LOCKRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADRESFAILURE CDERR_STRUCTSIZE
CDERR_LOADSTRFAILURE FNERR_BUFFERTOOSMALL
CDERR_MEMALLOCFAILURE FNERR_INVALIDFILENAME
CDERR_MEMLOCKFAILURE FNERR_SUBCLASSFAILURE

הערות

כברירת מחדל, Windows 95 ו- Windows NT גירסה 4.0 להציג גירסה חדשה של תיבת הדו-שיח שמור המספק תכונות ממשק משתמש דומה ל- Windows Explorer. באפשרותך לספק פרוצדורת hook OFNHookProc עבור תיבת הדו-שיח בסגנון Explorer לשמור . כדי להפעיל את השגרה הוו, הגדרת דגלים OFN_EXPLORER ו- OFN_ENABLEHOOK החבר בדגלים של מבנה הפרמטר OPENFILENAME , ציין את הכתובת של ההליך הוו חבר lpfnHook.

Windows 95 ו- Windows NT 4.0 ממשיכים לתמוך העתיקה-הסגנון בתיבת הדו-שיח שמור עבור יישומים שאינם מעוניינים לשמור על ממשק משתמש עקבי עם Windows 3.1 או ממשק המשתמש של Windows NT 3.51. כדי להציג בסגנון הישן תיבת הדו-שיח שמירה , לאפשר פרוצדורת hook OFNHookProcOldStyle ולהבטיח הדגל OFN_EXPLORER מוגדר לא.

חלונות CE: לא כל חברי המבנה הפרמטר OPENFILENAME מוגדרים ב- Windows CE. לקבלת מידע אודות חברי מוגדר, ראה את נושא הפניה עבור מבנה הפרמטר OPENFILENAME .

QuickInfo

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

ראה גם

סקירה נפוצות על תיבת הדו-שיח ספריית, פונקציות נפוצות של תיבת הדו-שיח, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, הפרמטר OPENFILENAME

Index