基本介紹
- 外文名：OFNHookProcOldStyle
- 類別：計算機函式
- 功能：接收指定給對話框函式的訊息通告
- 原型：HWND hdlg
OFNHookProcOldStyle簡介,OFNHookProcOldStyle參數,OFNHookProcOldStyle備註,
OFNHookProcOldStyle簡介
函式功能：LPOFNHOOKPROC類型定義了一個指向這種回調函式的指針。OFNHookProcOldStyle是應用程式定義的或庫定義的函式名的位置占有者。當創建一個Open或Save As公共對話框時，如果指定OFN_EXPLORER標誌且需一個掛鈎函式，那么必須套用一個Explorer_style的OFNHookProc掛鈎函式。
函式原型：UINT CALLBACK OFNHookProcOldStyle（HWND hdlg，UINT uiMsg WPARAM wParam，LPARAM IParam）；
OFNHookProcOldStyle參數
參數：
hdlg：指向訊息指定的Open或Save As對話框視窗。
uiMsg：標識接收的訊息。
wParam：指定有關訊息的其他信息。精確的意義要根據uiMSg參數的值來決定。
IParam：指定有關訊息的其他信息。精確的意義要根據uiMsg參數的值來決定。如果uiMsg參數顯示了WM_INITDIALOG訊息，IParam是一個指向OPENFILENAME結構的指針。該結構含有創建對話框時指定的值。
返回值：如果掛鈎函式返回零，預設對話框函式處理訊息；如果掛鈎函式返回非零值，預設對話框忽略訊息。
OFNHookProcOldStyle備註
備註：當用GetOpenFileName或GetSaveFileName函式創建一個舊式的Open或Save As對話框時。可以提供一個OFNHookProcOldStyle掛鈎函式。為使掛鈎函式生效，須套用傳遞到對話創建函式的OPENHLENAME結構，且須指定一個指向IpnHook成員中的掛鈎函式的指針，及指定Flags成員中OFN_ENABLEHOOK標識。如果掛鈎函式處理WM_CTLCOLORDLG訊息，那么必須返回一個有效的刷子句柄，以便繪製對話框的背景。總之，如果掛鈎函式處理任何一種WM_CTLCOLOR信息，那么必須返回一個有效的刷子句柄以繪製指定控制的背景。不須從掛鈎函式調用EndDialog函式。相反，掛鈎函式能調用PostMessage函式，把帶有IDABORT值的一個WM_COMMAND信息傳送給對話框函式PostingIDABORT，並關閉對話框，使對話框函式返回 FALSE值，若要了解為什麼掛鈎函式關閉對話框，必須提供掛鈎函式和應用程式之間的聯繫機理。可以對公共對話框的標準控制臺進行子分類。但是公共對話框函式也可以對控制臺進行子分類。正因如此，必須在掛鈎函式WM_INTDIALDG處理訊息時對控制臺子分類。這就保證對話框函式設定子分類函式之前，子分類函式接收指定的控制訊息。
速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；頭檔案：commdlg.h；庫檔案：用戶自定義。
