函式原型
BOOL GetOpenFileName(LPOPENFILENAME Ipofn);
參數
Ipofn:指向包含初始化對話框的信息的一個OPENFILENAME結構。當OpenfileName函式返回時,此結構包含有關用戶檔案選擇的信息。
返回值:如果用戶指定了一個檔案名稱,點擊OK按鈕,返回值為非零。由OPENFILENAME結構的IPstrFile成員指向的緩衝區含有全路徑和用戶指定的檔案名稱。如果用戶取消或關閉Open對話框或錯誤出現,返回值為零。若想獲得更多的錯誤信息,請調用CommDlgExtendedError函式。
備註:從Windows 95和Windows NT 4.0版開始,預設的Open對話框提供了與Windows Explorer相似的用戶界面特徵。可以為一個瀏覽器風格的Open對話框提供一個OFNHOOKProc掛鈎函式。設定OPENFILFNAME結構的Flags成員中OFN_EXPLORER和OFN_ENABLEHOOK標示和指定IpfnHook成員中掛鈎函式的地址,可使掛鈎函式生效。
Windows 95和Windows NT仍支持舊風格的Open對話框以便維持與一個Windows 3.1或Windows NT3.51用戶界面相一致的用戶界面。使OFNHOOKProcOldstyle掛鈎函式生效和保證OFN_EXPLORER標誌沒有被設定,就可以顯示舊式的Open對話框。
為顯示允許用戶選擇一個目錄而不是一個檔案的對話框,要調用SHBrowseForFolder函式。
Windows CE:並不是每一個OPENFILENAME結構的成員都在Windows CE中被定義。有關定義成員的更多的信息,請參見OPENFILENAME結構的資料主題。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;頭檔案:COmmdlg.h;庫檔案:comdlg32.lib;Unlcode:在Windows NT環境中實現為Unicode和ANSI兩個版本。