Método CBaseWindow.SetPalette (Winutil.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O SetPalette método instala uma paleta para a janela.

Sintaxe

virtual HRESULT SetPalette(
   HPALETTE hPalette
);

Parâmetros

hPalette

Manipule para a nova paleta. Não pode ser NULL.

Retornar valor

Retorna um dos valores HRESULT mostrados na tabela a seguir.

Código de retorno Descrição
S_FALSE
 Uma chamada interna para GdiFlush retornou um erro.
S_OK
 Êxito.

Comentários

Se o valor da variável de membro CBaseWindow::m_bNoRealize for FALSE (o padrão), esse método selecionará a paleta e a perceberá. Caso contrário, ele seleciona a paleta, mas não a percebe. O objeto não exclui nenhuma paleta anterior que ele estava usando. O chamador é responsável por excluir paletas.

Qualquer thread pode chamar esse método com segurança, não apenas o thread que possui a janela. A janela envia uma mensagem privada para si mesma, que dispara uma chamada para o método CBaseWindow::OnPaletteChange .

Requisitos

Requisito Valor
parâmetro
Winutil.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CBaseWindow