共用方式為


LPCCHOOKPROC 回呼函式 (commdlg.h)

接收用於 [色彩 ] 對話框之預設對話框程式的訊息或通知。 這是與 ChooseColor 函式搭配使用的應用程式定義或連結庫定義回呼函式。

LPCCHOOKPROC 類型會定義這個回呼函式的指標。 CCHookProc 是應用程式定義函數名稱的佔位元。

語法

LPCCHOOKPROC Lpcchookproc;

UINT_PTR Lpcchookproc(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

參數

unnamedParam1

訊息預定之 [色彩 ] 對話框的句柄。

unnamedParam2

正在接收之訊息的標識碼。

unnamedParam3

有關訊息的其他資訊。 確切的意義取決於 unnamedParam2 參數的值。

unnamedParam4

有關訊息的其他資訊。 確切的意義取決於 unnamedParam2 參數的值。 如果 unnamedParam2 參數指出 WM_INITDIALOG 訊息, 則 unnamedParam4CHOOSECOLOR 結構的指標,其中包含建立對話框時所指定的值。

傳回值

如果攔截程式傳回零,則默認對話框程式會處理訊息。

如果攔截程式傳回非零值,則默認對話框程式會忽略訊息。

備註

當您使用 ChooseColor 函式建立 Color 對話框時,您可以提供 CCHookProc 攔截程式來處理用於對話框程式的訊息或通知。 若要啟用攔截程式,請使用您傳遞至對話框建立函式的 CHOOSECOLOR 結構。 在 lpfnHook 成員中指定攔截程式的位址,並在 Flags 成員中指定CC_ENABLEHOOK旗標。

默認對話框程式會先處理 WM_INITDIALOG 訊息,再將其傳遞至攔截程式。 對於所有其他訊息,攔截程式會先接收訊息。 然後,攔截程式的傳回值會決定默認對話程式是否處理訊息或忽略它。

如果攔截程式處理 WM_CTLCOLORDLG 訊息,它必須傳回有效的筆刷句柄,才能繪製對話框的背景。 一般而言,如果攔截程序處理任何 WM_CTLCOLOR* 訊息,它必須傳回有效的筆刷句柄,才能繪製指定控件的背景。

請勿從攔截程式呼叫 EndDialog 函式。 相反地,攔截程式可以呼叫PostMessage函式,將具有IDABORT值的WM_COMMAND訊息張貼至對話框程式。 張貼 IDABORT 會關閉對話框,並讓對話框函式傳回 FALSE。 如果您需要知道攔截程式為何關閉對話框,您必須在攔截程式與應用程式之間提供自己的通訊機制。

您可以將通用對話框的標準控件子類別化。 不過,對話框程式也可以子類別化控件。 因此,當您的攔截程式處理 WM_INITDIALOG 訊息時,您應該使用子類別控件。 這可確保您的子類別程式會在對話框程式所設定的子類別程式之前,接收控件特定的訊息。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 commdlg.h (包含 Windows.h)

另請參閱

CHOOSECOLOR

ChooseColor

通用對話框連結庫

概念

EndDialog

PostMessage

參考

WM_CTLCOLORDLG

WM_INITDIALOG