Metodo CBaseWindow.SetPalette (Winutil.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il SetPalette metodo installa una tavolozza per la finestra.

Sintassi

virtual HRESULT SetPalette(
   HPALETTE hPalette
);

Parametri

hPalette

Gestire la nuova tavolozza. Impossibile essere NULL.

Valore restituito

Restituisce uno dei valori HRESULT visualizzati nella tabella seguente.

Codice restituito Descrizione
S_FALSE
Una chiamata interna a GdiFlush ha restituito un errore.
S_OK
Operazione completata.

Commenti

Se il valore della variabile membro CBaseWindow::m_bNoRealize è FALSE (impostazione predefinita), questo metodo seleziona la tavolozza e lo rende conto. In caso contrario, seleziona la tavolozza, ma non lo rende conto. L'oggetto non elimina alcuna tavolozza precedente usata. Il chiamante è responsabile dell'eliminazione delle tavolozze.

Qualsiasi thread può chiamare in modo sicuro questo metodo, non solo il thread proprietario della finestra. La finestra invia un messaggio privato a se stesso, che attiva una chiamata al metodo CBaseWindow::OnPaletteChange .

Requisiti

Requisito Valore
Intestazione
Winutil.h (includere Streams.h)
Libreria
Strmbase.lib (build al dettaglio);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBaseWindow