CWnd::OnPaletteChanged

2011-08-09

入力フォーカスを持つウィンドウが論理パレットを実現したためにシステムパレットが変更された後に、システムパレットを変更した後に、すべてのトップレベルウィンドウに対して、フレームワークからこのメンバー関数が呼び出されます。

afx_msg void OnPaletteChanged(
   CWnd* pFocusWnd 
);

パラメーター

pFocusWnd
システムパレットが変更される原因となったウィンドウへのポインターを指定します。このポインターは一時的である場合があるので、後で使用するために保持しておくことはできません。

解説

この関数により、カラーパレットを使う入力フォーカスを持たないウィンドウが論理パレットを実現し、クライアント領域を更新できます。

OnPaletteChanged メンバー関数は、システムパレットを変更したために WM_PALETTECHANGED メッセージが送信される原因となったウィンドウを含む、すべてのトップレベルウィンドウおよびオーバーラップウィンドウに対して呼び出されます。カラーパレットを使用する子ウィンドウがある場合は、その子ウィンドウにこのメッセージを送る必要があります。

無限ループの発生を避けるため、pFocusWnd にそのウィンドウ自体へのポインターが含まれていないことを確認するまでは、パレットを実現しないでください。

注意

このメンバー関数は、アプリケーションが Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。この関数に渡されるパラメーターの値は、フレームワークがメッセージ受信時に受け取ったパラメーターの値に基づいています。この関数の基本クラスの実装を呼び出した場合は、関数に渡したパラメーターではなく、メッセージと共に渡されたパラメーター自体が使用されます。