公共對話框——OPENFILENAME結構

今天在網上搜這個的時候, 看到有人遇到某錯誤問了半天也沒人理. 其實memset初始化一下就可以了.

--------相關資料--------------------

OPENFILENAME

OPENFILENAME結構包含了GetOpenFileName和GetSaveFileName函數用來初始化打開或另存為對話框的信息。在用戶關閉對話框后，系統返回關于用戶的選擇信息到這個結構中。

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)
} OPENFILENAME, *LPOPENFILENAME; 

成員

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 2000：

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

Windows 98：

1. lpstrInitialDir指定初始目錄。
2. 如果lpstrInitialDir是NULL并且lpstrFile包含了一個路徑，那么這個路徑就是初始目錄。
3. 否則，如果當前目錄包含了一些指定的過濾類型的文件，那么初始化目錄是當前目錄。
4. 否則，初始目錄是當前用戶的私人文件目錄（即我的文檔）。

Windows和Windows NT/ 2000的早期版本：

1. lpstrInitialDir指定初始目錄。
2. 如果lpstrInitialDir是NULL并且lpstrFile包含了一個路徑，那么這個路徑就是初始目錄。
3. 否則，初始目錄是當前目錄。

lpstrTitle

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

Flags

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

標記	含意
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< />

posted on 2007-07-29 17:06 楊粼波 閱讀(836) 評論(0)  編輯 收藏 引用