CBaseWindow.SetPalette メソッド (Winutil.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
メソッドは SetPalette
、ウィンドウのパレットをインストールします。
構文
virtual HRESULT SetPalette(
HPALETTE hPalette
);
パラメーター
-
hPalette
-
新しいパレットにハンドルします。 NULL にすることはできません。
戻り値
次の表に示す HRESULT 値のいずれかを返します。
リターン コード | 説明 |
---|---|
|
GdiFlush の内部呼び出しでエラーが返されました。 |
|
成功しました。 |
解説
CBaseWindow::m_bNoRealize メンバー変数の値が FALSE (既定値) の場合、このメソッドはパレットを選択して認識します。 それ以外の場合、パレットは選択されますが、認識されません。 オブジェクトは、使用していた以前のパレットを削除しません。 呼び出し元はパレットの削除を担当します。
どのスレッドでも、ウィンドウを所有するスレッドだけでなく、このメソッドを安全に呼び出すことができます。 ウィンドウは、 CBaseWindow::OnPaletteChange メソッドの呼び出しをトリガーするプライベート メッセージをそれ自体に送信します。
要件
要件 | 値 |
---|---|
ヘッダー |
|
ライブラリ |
|