WM_CTLCOLORDLG訊息

在系統繪製對話方塊之前傳送至對話方塊。藉由回應此訊息，對話方塊可以使用指定的顯示裝置內容控制碼來設定其文字和背景色彩。

#define WM_CTLCOLORDLG                  0x0136

參數

如果應用程式處理此訊息，它必須傳回筆刷的控制碼。系統會使用筆刷繪製對話方塊的背景。

DefWindowProc函式預設會選取對話方塊的預設系統色彩。

系統不會自動終結傳回的筆刷。當不再需要筆刷時，應用程式必須負責終結筆刷。

執行緒之間永遠不會傳送 WM_CTLCOLORDLG 訊息。它只會在一個執行緒內傳送。

請注意， WM_CTLCOLORDLG 訊息會傳送至對話方塊本身;所有其他 WM_CTLCOLOR* 訊息都會傳送給控制項的擁有者。

如果對話方塊程式處理此訊息，它應該會將所需的傳回值轉換成 INT_PTR ，並直接傳回值。如果對話方塊程式傳回 FALSE，則會執行預設訊息處理。 會忽略 SetWindowLong函式所設定的DWL_MSGRESULT值。

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