Método CBaseWindow.SetPalette (Winutil.h)

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El SetPalette método instala una paleta para la ventana.

Sintaxis

virtual HRESULT SetPalette(
   HPALETTE hPalette
);

Parámetros

hPalette

Controle a la nueva paleta. No puede ser NULL.

Valor devuelto

Devuelve uno de los valores HRESULT que se muestran en la tabla siguiente.

Código devuelto Descripción
S_FALSE
 Una llamada interna a GdiFlush devolvió un error.
S_OK
 Correcto.

Observaciones

Si el valor de la variable miembro CBaseWindow::m_bNoRealize es FALSE (valor predeterminado), este método selecciona la paleta y la da cuenta. De lo contrario, selecciona la paleta pero no la da cuenta. El objeto no elimina ninguna paleta anterior que estaba usando. El autor de la llamada es responsable de eliminar paletas.

Cualquier subproceso puede llamar de forma segura a este método, no solo al subproceso propietario de la ventana. La ventana envía un mensaje privado a sí mismo, que desencadena una llamada al método CBaseWindow::OnPaletteChange .

Requisitos

Requisito Value
Encabezado
Winutil.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseWindow (clase)