LPSETUPHOOKPROC 回呼函式 (commdlg.h)

發行項
02/26/2024

搭配 PrintDlg 函式使用的應用程式定義或連結庫定義回呼函式。攔截程式會接收用於 [列印安裝 ] 對話框之預設對話框程式的訊息或通知。

LPSETUPHOOKPROC 類型會定義這個回呼函式的指標。 SetupHookProc 是應用程式定義或連結庫定義函數名稱的佔位元。

語法

LPSETUPHOOKPROC Lpsetuphookproc;

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

參數

unnamedParam1

訊息預定的 [列印安裝 ] 對話框句柄。

unnamedParam2

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

unnamedParam3

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

unnamedParam4

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

傳回值

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

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

備註

[ 列印安裝 ] 對話方塊已被 [ 頁面設定 ] 對話框取代，此對話框應該供新應用程式使用。不過，為了相容性， PrintDlg 函式會繼續支持顯示 [ 列印安裝 ] 對話框。您可以為 [列印安裝] 對話方塊提供 SetupHookProc 攔截程式，以處理用於對話框程式的訊息或通知。

若要啟用攔截程式，請使用您傳遞至對話框建立函式的 PRINTDLG 結構。在 lpfnSetupHook 成員中指定攔截程式的位址，並在 Flags 成員中指定PD_ENABLESETUPHOOK旗標。

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

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

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

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

規格需求

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