GetOpenFileName

函數作用：

該函數創建一個Open公共對話框，使用戶指定驅動器、目錄和文件名、或使用戶打開文件。

 

函數原型：

BOOL GetOpenFileName（LPOPENFILENAME Ipofn）;

 

參數：

• Ipofn：指向包含初始化對話框的信息的一個OPENFILENAME結構。當OpenfileName函數返回時，此結構包含有關用戶文件選擇的信息。

 

返回值：

• 如果用戶指定了一個文件名，點擊OK按鈕，返回值為非零。
• 由 OPENFILENAME 結構的 IPstrFile 成員指向的緩沖區含有全路徑和用戶指定的文件名。如果用戶取消或關閉 Open 對話框或錯誤出現，返回值為零。若想獲得更多的錯誤信息，請調用 CommDlgExtendedError 函數。. Y- R9 @# v; \) _/ a& B, ~6 G

在使用前要先初始化 OPENFILENAME 這個結構哦。

typedef struct tagOFN
{
   DWORD lStructSize;
　　HWND hwndOwner;
　　HINSTANCE hInstance;
　　LPCTSTR lpstrFilter;
   LPTSTR lpstrCustomFilter;
　　DWORD nMaxCustFilter;
　　DWORD nFilterIndex;
　　LPTSTR lpstrFile;
　　DWORD nMaxFile;
　　LPTSTR lpstrFileTitle;
　　DWORD nMaxFileTitle;
　　LPCTSTR lpstrInitialDir;
　　LPCTSTR lpstrTitle;
　　DWORD Flags;
　　WORD nFileOffset;
　　WORD nFileExtension;
　　LPCTSTR lpstrDefExt;
　　LPARAM lCustData;
　　LPOFNHOOKPROC lpfnHook;
　　LPCTSTR lpTemplateName;
　　#if (_WIN32_WINNT >= 0x0500)
   void * pvReserved;
　　DWORD dwReserved;
　　DWORD FlagsEx;
    #endif // (_WIN32_WINNT >= 0x0500). D" _- C. A! A/ S3 f
} OPENFILENAME, *LPOPENFILENAME;

OPENFILENAME 各個成員詳細注釋（有點小長）：

lStructSize
　　指定這個結構的大小，以字節為單位。
　　Windows 95/98和Windows NT 4.0：特意為Windows 95/98或Windows NT 4.0，及帶有WINVER和_WIN32_WINNT >= 0x0500編譯時，為這個成員使用OPENFILENAME_SIZE_VERSION_400。
　　Windows 2000及更高版本：這個參數使用sizeof (OPENFILENAME) 。

hwndOwner
　　指向所有者對話框窗口的句柄。這個成員可以是任意有效窗口句柄，或如果對話框沒有所有者它可以為NULL。

hInstance
　　如果在Flags成員中設置了OFN_ENABLETEMPLATEHANDLE標記，hInstance成員指向包含一個對話框模板的內存對象。如果OFN_ENABLETEMPLATE標記被設置，hInstance是一個指向通過lpTemplateName成員命名的對話框模板的模塊。如果兩者都沒有被設置，這個成員被忽略。
　　如果OFN_EXPLORER標記被設置，系統使用Explorer風格的默認對話框的子窗口作為指定模板來建立一個對話框。如果OFN_EXPLORER標記沒有被設置，系統使用模板建立一個舊風格的對話框。

lpstrFilter
　　指向一對以空字符結束的過濾字符串的一個緩沖。緩沖中的最后一個字符串必須以兩個NULL字符結束。
　　第一個字符串是過濾器描述的顯示字符串（例如，“文本文件”），第二個字符指定過濾樣式（例如，“*.TXT”）。要為一個顯示字符串指定多個過濾樣式，使用分號（“;”）分隔樣式（例如，“*.TXT;*.DOC;*.BAK”）。一個樣式字符串中可以包含有效的文件名字字符及星號（*）通配符。不能在樣式字符串中包含空格。
　　系統不能改變過濾器的次序。它按lpstrFilter指定的次序顯示在文件類型組合框中。
　　如果lpstrFilter是NULL，對話框不能顯示任何過濾器。

lpstrCustomFilter
　　指向一個靜態緩沖，它包含了一對以空字符結束的過濾器字符串，這個字符串是為了保留用戶選擇的過濾樣式。第一個字符串是描述定制過濾器的顯示字符串，第二個字符串是被用戶選擇的過濾器樣式。第一次你的應用程序建立對話框，你指定的第一個字符串可以是任何非空的字符串。當用戶選擇了一個文件時，對話框復制當前過濾樣式到第二個字符串。保留過濾樣式可以是在lpstrFilter緩沖中指定的樣式之一，或是用戶輸入的過濾器樣式。在下一次對話框被建立時系統使用這個字符串去初始化用戶自定義的文件過濾器。如果nFilterIndex成員是0，對話框使用定制過濾器。
　　如果這個成員是NULL，對話框不能保留用戶自定義過濾器樣式。
　　如果這個成員不是NULL，nMaxCustFilter成員的值必須指定以TCHARs為單位的lpstrCustomFilter緩沖的大小。對於ANSI版本，是字節的個數；對於Unicode版本，是字符的個數。

nMaxCustFilter
　　指定特意為lpstrCustomFilter准備的以TCHARs為單位的緩沖大小。對於ANSI版本，是字節的個數；對於Unicode版本，是字符的個數。這緩沖應該最小在40個字符長。如果lpstrCustomFilter成員是NULL或是指向NULL的字符串，這個成員被忽略

nFilterIndex
　　指定在文件類型控件中當前選擇的過濾器的索引。緩沖指向被lpstrFilter包含的一對定義了的過濾器的字符串。過濾器的第一對字符串的索引值為1，第二對為2，等等。0索引指出是通過lpstrCustomFilter指定的定制過濾器。你可以為對話框指定一個索引作為最初的過濾器描述及過濾器樣式。當用戶選擇了一個文件時，nFilterIndex返回當前顯示的過濾器的索引。
　　如果nFilterIndex是0及lpstrCustomFilter是NULL，系統使用在lpstrFilter緩沖中的第一個過濾器。如果所有的三個成員都是0或NULL，系統不使用任何過濾器，在對話框的列表文件中不顯示任何文件。

lpstrFile
　　指向包含初始化文件名編輯控件使用的文件名的緩沖。如果不需要初始值，這個緩沖的第一個字符必須是NULL。當GetOpenFileName或GetSaveFileName函數返回成功時，這個緩沖包含驅動器，路徑，文件名，及所選擇的文件的擴展名。
　　如果OFN_ALLOWMULTISELECT標記被設置並且用戶選擇了多個文件，緩沖包含了當前目錄下被選擇文件的文件名。對於Explorer風格對話框，目錄和文件名字符串是被NULL分開的，在文件名之后有一個額外的NULL。對於舊風格對話框，字符串是被空格分開的並且函數為帶有空格的文件名使用短文件名。你可以使用FindFirstFile函數在長短文件名之間轉換。如果用戶只選擇了一個文件，lpstrFile字符串在路徑和文件名之間沒有分隔。
　　如果緩沖太小，函數返回FALSE並且CommDlgExtendedError函數返回FNERR_BUFFERTOOSMALL.。既然這樣，lpstrFile緩沖的首先兩個字節包含必需的大小（字節或字符）。

nMaxFile!
　　指定lpstrFile緩沖的大小，以TCHARs為單位。對於ANSI版本，是字節的個數；對於Unicode版本，是字符的個數。這個緩沖必須足夠存儲路徑和文件名字符串，包含結尾的null字符。如果緩沖太小，GetOpenFileName和GetSaveFileName函數返回假（FALSE）緩沖最小應該在256個字符

lpstrFileTitle
　　指向接收選擇的文件的文件名和擴展名的緩沖（不帶路徑信息）。這個成員可以是NULL。

nMaxFileTitle
　　指定lpstrFileTitle緩沖的大小，以TCHARs為單位。對於ANSI版本，是字節的個數；對於Unicode版本，是字節的個數。如果lpstrFileTitle是NULL，這個成員被忽略。

lpstrInitialDir
　　指向以空字符結束的字符串，可以在這個字符串中指定初始目錄。Pointer to a null terminated string that can specify the initial directory. 在不同的平台上，為選擇初始目錄有不同的運算法則。

　　Windows 7：
　　如果lpstrInitialDir與應用程序第一次使用打開或另存為對話框的值相同，路徑由用戶選擇作為初始目錄。
　　否則，如果lpstrFile包含路徑，路徑是初始目錄。
　　否則，如果lpstrInitialDir不是NULL，它指定初始目錄。
　　如果lpstrInitialDir為NULL，並且當前目錄包含有一些指定過濾器類型的文件，初始目錄是當前目錄。
　　否則，初始目錄是當前用戶的個人目錄（即我的文檔）。
　　否則，初始目錄是桌面文件夾。

　　Windows 2000：
　　如果lpstrFile包含了一個路徑，這個路徑就是初始目錄。
　　否則，lpstrInitialDir指定的為初始目錄。
　　如果lpstrInitialDir為NULL，並且當前目錄下包含有一些指定過濾器類型的文件，初始目錄就是當前目錄。
　　否則，如果應用程序在過去使用過打開哐另存為對話框，使用最近選擇的路徑作為初始目錄。然而，如果一個應用程序長時間沒有運行過，它保存的選擇的路徑將被丟棄。
　　否則，初始目錄是當前用戶的私人文件目錄（即我的文檔）。
　　否則，初始目錄是桌面文件夾。

　　Windows 98：
　　lpstrInitialDir指定初始目錄。
　　如果lpstrInitialDir是NULL並且lpstrFile包含了一個路徑，那么這個路徑就是初始目錄。
　　否則，如果當前目錄包含了一些指定的過濾類型的文件，那么初始化目錄是當前目錄。
　　否則，初始目錄是當前用戶的私人文件目錄（即我的文檔）。
　　Windows和Windows NT/ 2000的早期版本：
　　lpstrInitialDir指定初始目錄。
　　如果lpstrInitialDir是NULL並且lpstrFile包含了一個路徑，那么這個路徑就是初始目錄。
　　否則，初始目錄是當前目錄。

lpstrTitle
　　指向在對話框的標題欄中放置的字符串。如果這個成員是NULL，系統使用默認標題（另存為或打開）

Flag
　　位標記的設置，你可以使用來初始化對話框。當對話框返回時，它設置的這些標記指出用戶的輸入。這個成員可以是下列標記的組合。 標記 含意

　　OFN_ALLOWMULTISELECT 指定文件名列表框允許多選。如果同時你設置了OFN_EXPLORER標記，對話框使用Explorer風格用戶界面；否則它使用舊風格用戶界面。
　　如果用戶選擇了一個以上的文件，lpstrFile緩沖返回當前目錄下所有被選擇的文件的文件名。nFileOffset成員是到第一個文件名的偏移量（字節或字符），並且nFileExtension成員不被使用。對於Explorer風格對話框，目錄和文件名是被NULL分隔的，在最后的文件名后帶有額外的NULL。這個格式使Explorer風格的對話框能返回包含空格的長文件名。對於舊風格對話框，目錄和文件字符串是被空格分隔的，函數為帶有空格的文件名使用短文件名。你可以使用FindFirstFile函數在短文件名和長文件名之間轉換。
　　如果你為一個舊風格對話框指定了一個定制的模板，文件名列表框的定義必須包含LBS_EXTENDEDSEL值。

　　OFN_CREATEPROMPT 如果用戶指定了一個不存在的文件，這個標記使用對話框能提示用戶是否新建這個文件。如果用戶選擇了新建這個文件，對話框關閉並且函數返回指定的名字；否則，對話框繼續停留。如果你使用帶有OFN_ALLOWMULTISELECT標記的這個標記，對話框允許用戶去指定一個不存在的文件。

　　OFN_DONTADDTORECENT Windows 2000：防止系統為選擇的文件增加快捷鏈接到最近使用文檔中。要找回目錄的位置，調用還有CSIDL_RECENT標記的SHGetSpecialFolderLocation函數。

　　OFN_ENABLEHOOK 激活在lpfnHook成員中指定的鈎子函數。

　　OFN_ENABLEINCLUDENOTIFY Windows 2000：當用戶打開一個文件夾時，引起對話框發送CDN_INCLUDEITEM通知消息到你的OFNHookProc程序。對話框為在最近打開的文件夾中的每一個項目發送一個通知。這些消息使你能夠控制那些在對話框中顯示的文件夾項目的列表。

　　OFN_ENABLESIZING Windows 2000，Windows 98：使Explorer風格的對話框可以使用鼠標或鍵盤調整大小。缺省時，Explorer風格的打開和另存為對話框允許被調整大小，不顧這個標記是否被設置。這標記僅在你提供了一個鈎子程序或定制模板時是必需的。舊風格的對話框不允許調整大小。

　　OFN_ENABLETEMPLATE 指出lpTemplateName成員是指向對話框模板資源的名字，這個模板資源在能被hInstance成員識別的模塊中。

　　如果OFN_EXPLORER標記被設置，系統使用指定的模板去建立一個對話框，是默認Explorer風格對話框的子窗口。如果OFN_EXPLORER標記沒有被設置，系統使用舊風格的對話框替代默認的對話框。

　　OFN_ENABLETEMPLATEHANDLE 指出hInstance成員能識別的包含預載對話框模板的數據塊。如果這個標記被指定的，系統忽略lpTemplateName。
　　如果OFN_EXPLORER標記被設置，系統使用指定的模板去建立一個對話框，是默認Explorer風格對話框的子窗口。如果OFN_EXPLORER標記沒有被設置，系統使用模板去建立一個舊風格對話框替代默認對話框。:

　　OFN_EXPLORER 指出任何打開或另存為對話框使用新的Explorer風格的用戶化模塊。關於更多的信息，參見Explorer-Style Hook Procedures和Explorer-Style Custom Templates。

　　缺省下，打開和另存為對話框使用Explorer風格用戶界面，不顧這個標記是否設置。這個標記僅在你提供了一個鈎子程序或定制模板或設置了OFN_ALLOWMULTISELECT標記時是必需的。
　　如果你想使用舊風格的界面，省略OFN_EXPLORER 標記，並且提供一個代替的舊風格模板或鈎子程序。如果你想用舊風格但不需要一個定制模板或鈎子程序，簡單的提供一個鈎子程序，讓它返回FALSE。

　　OFN_EXTENSIONDIFFERENT 指定用戶輸入的一個文件的擴展名與lpstrDefExt指定的擴展名不同。如果lpstrDefExt是NULL，函數不使用這個標記。

　　OFN_FILEMUSTEXIST 指定用戶僅可以在文件名登錄字段中輸入已存在的文件的名字。如果這個標記被指定的並且用戶輸入了一個無效的名字，對話框程序顯示一個等待消息框。如果這個標記被指定，OFN_PATHMUSTEXIST標記也被使用。

　　OFN_FORCESHOWHIDDEN Windows 2000：強制顯示系統和隱藏屬性的文件，從而壓倒用戶設置的顯示或不顯示隱藏文件。否則，帶有系統和隱藏標記的文件不被顯示。

　　OFN_HIDEREADONLY 隱藏只讀復選框。

　　OFN_LONGNAMES 對於舊風格對話框，這個標記引起對話框使用長文件名。如果這個標記沒有被指定，或如果OFN_ALLOWMULTISELECT標記也被設置，舊風格對話框為帶有空格的文件名使用短文件名（8.3格式）。
　　Explorer風格對話框忽略這個標記，通常顯示長文件名。

　　OFN_NOCHANGEDIR 如果當搜索文件時用戶改變了目錄的時候，恢復當前目錄到它的初始值。

　　OFN_NODEREFERENCELINKS 引導對話框為選擇的快捷方式（.LNK）文件返回路徑和文件名。如果這個值沒有被指定，對話框返回這個快捷方式所引用文件的路徑和文件名

　　OFN_NOLONGNAMES 對於舊風格對話框，這個標識引起對話框去使用短文件名（8.3格式）
　　Explorer風格對話框忽略這個標記，通常顯示長文件名。

　　OFN_NONETWORKBUTTON 隱藏和顯示風格按鈕。-

　　OFN_NOREADONLYRETURN 指定返回的文件不帶有只讀復選框，不是在寫保護的目錄中。

　　OFN_NOTESTFILECREATE 指定文件不是在對話框關閉前建立的。如果應用程序保存文件到一個建立的非映象風格共享上，這個標記應該被指定的。當一個應用程序指定了這標記，庫不能檢查寫保護，磁盤滿，打開驅動器門或網絡保護。應用程序使用這個標記必須小心執行文件操作，因為一旦文件被關閉，它不能重新打開。

　　OFN_NOVALIDATE 指定公共對話框允許在返回的文件名中有無效的字符。典型的，正在調用的程序使用一個鈎子程序通過FILEOKSTRING消息檢查文件名。如果在編輯控件中的文本框是空的或只包含了空格，那么文件和目錄列表框是被更新的。如果編輯控件中的文本框包含了別的東西，那么nFileOffset和nFileExtension的設置值是通過分析文本產生的。沒有默認的擴展名被添加到文本，也沒有文本被復制到lpstrFileTitle指定的緩沖。

　　如果通過nFileOffset指定的值比0小，文件是無效的。否則，文件名是有效的。如果OFN_NOVALIDATE沒有被指定，nFileExtension和nFileOffset可以被使用。

　　OFN_OVERWRITEPROMPT 如果選擇的文件已經存在，使用另存為對話框產生一個消息框。用戶必須確認是否覆蓋這個文件。

　　OFN_PATHMUSTEXIST 指定用戶僅能輸入的路徑和文件名。如果這個標記被使用並且用戶在文件名輸入字段中鍵入了一個用效的路徑和文件名，對話框函數顯示一個等待消息。

　　OFN_READONLY 當對話框建立時，顯示被選擇的只讀復選框。這個標記指出當對話框被關閉時只讀復選框的狀態。

　　OFN_SHAREAWARE 指出如果調用OpenFile函數因為網絡共享沖突而失敗，這個錯誤被忽略並且對話框返回選擇的文件名。

　　如果這個標記沒有被設置，當用戶選擇的文件名發生網絡共享沖突時，對話框發送通知到你的鈎子程序。如果你設置了OFN_EXPLORER標記，對話框發送CDN_SHAREVIOLATION消息到鈎子程序。如果你沒有設置OFN_EXPLORER，對話框發送SHAREVISTRING注冊的消息到鈎子程序。

　　OFN_SHOWHELP 使對話框顯示幫助按鈕。hwndOwner成員必須指定一個窗口，這個窗口作為接收對話框發送的HELPMSGSTRING注冊的消息，當用戶單擊幫助按鈕時對話框發送這個消息。3 C; D. g2 O- _
　　當用戶單擊幫助按鈕時，一個Explorer風格的對話框發送CDN_HELP通知消息到你的鈎子程序。

nFileOffset
　　指定從路徑開始到通過lpstrFile指定的文件名字符串基於0的偏移，以TCHARs為單位。對於ANSI版本，是字節的個數；對於Unicode版本，是字符的個數。例如，如果lpstrFile指向下列的字符串，“c:\dir1\dir2\file.ext”，這個成員包含指出“file.ext”字符串偏移的位置值13。
　　如果用戶選擇了多於一個的文件，nFileOffset是到第一個文件名的偏移。

nFileExtension
　　指定從路徑開始到通過lpstrFile指定的文件名字符串中擴展名基於0的偏移，以TCHARs為單位。對於ANSI版本，是字節的個數；對於Unicode版本，是字節的個數。例如，如果lpstrFile指向下列的字符串，“c:\dir1\dir2\file.ext”，這個成員包含的值是18。如果用戶沒有輸入一個擴展名並且lpstrDefExt是NULL，這個成員指定的偏移是結束字符NULL。如果用戶在文件名中輸入一個“.”作為最后的字符，這個成員是0。

lpstrDefExt
　　指向包含默認擴展名的緩沖。如果用戶忘記輸入擴展名，GetOpenFileName和GetSaveFileName附加這個擴展名到文件名中。這個字符串可以是任一長度，但但只有頭三個字符被附加。字符串不應該包含一個句點（.）。如果這個成員是NULL並且用戶忘記了輸入一個擴展名，那么將沒有擴展名被附加。

lCustData
　　指定應用程序定義的數據，這數據是能被lpfnHook成員識別的系統傳到的鈎子程序。當系統發送WM_INITDIALOG消息到程序，消息的lParam參數指向當對話框建立時指定的OPENFILENAME結構。鈎子程序可以使用這個指針獲得lCustData的值

lpfnHook
　　指向一個鈎子程序。除非Flags成員中包含OFN_ENABLEHOOK標記，要么這個成員將被忽略。
　　如果在Flags成員中OFN_EXPLORER標記沒有被設置，lpfnHook指向一個OFNHookProcOldStyle鈎子程序，這個程序有意的從對話框接收消息。鈎子程序返回FALSE傳遞一個消息到默認的對話框程序或返回TRUE丟棄消息。
　　如果OFN_EXPLORER被設置，lpfnHook指向一個OFNHookProc鈎子程序。這個鈎子程序接收從對話框發出的通知消息。這個鈎子程序也接收你通過一個子對話框模板定義的附加控件的消息。鈎子程序不有意接收默認對話框的標准控件的消息。

lpTemplateName
　　指向一個以空字符結束的字符串，字符串是對話框模板資源的名字，資源保存在能被hInstance成員識別的模塊中。對於有限的對話框資源，這可以是通過MAKEINTRESOURCE返回的值。除非在Flags成員中設置了OFN_ENABLETEMPLATE標記，要么這個成員被忽略。
　　如果OFN_EXPLORER標記被設置，系統使用指定的模板去建立一個對話框，是默認Explorer風格對話框的子窗口。如果OFN_EXPLORER標記沒有被設置，系統使用模板去建立一個舊風格的對話框來替代默認對話框。
　　pvReserved
　　保留。
　　dwReserved
　　保留。
　　FlagsEx
　　Windows 2000：設置位標記，你可以使用來初始化對話框。這個成員可以是下列標記的組合。 標記 含意
　　OFN_EX_NOPLACESBAR 如果這個標記被設置，則位置欄被不顯示。如果這個標記沒有設置，則Explorer風格的對話框包含一般使用文件圖標的位置欄，例如像收藏夾和桌面。

這是一個栗子：

 

OPENFILENAME ofn;
nchar strFile[MAX_PATH];


// 對 OPENFILENAME 進行初始化
@memset(&ofn,0,sizeof(OPENFILENAME));
memset(strFile,0,sizeof(char)*MAX_PATH);
ofn.lStructSize = sizeof(OPENFILENAME);
bofn.lpstrFilter = "網頁(*.html)\0*.html*;*.htm*\0";
ofn.lpstrFile = strFile;
ofn.nMaxFile = MAX_PATH;
ofn.Flags = OFN_FILEMUSTEXIST;
if(GetOpenFileName(&stFile))   //strFile得到用戶所選擇文件的路徑和文件名 ; 
{
　　PathStripPath(strFile);    //strFile得到文件名
}