LPCCHOOKPROC 回呼函式 (commdlg.h)

發行項
02/26/2024

接收用於 [色彩 ] 對話框之預設對話框程式的訊息或通知。這是與 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 訊息， 則 unnamedParam4 是 CHOOSECOLOR 結構的指標，其中包含建立對話框時所指定的值。

傳回值

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

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

備註

當您使用 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)