Méthode CBaseWindow.SetPalette (Winutil.h)
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La SetPalette méthode installe une palette pour la fenêtre.
Syntaxe
virtual HRESULT SetPalette(
HPALETTE hPalette
);
Paramètres
-
hPalette
-
Handle vers la nouvelle palette. Ne peut pas être NULL.
Valeur renvoyée
Retourne l’une des valeurs HRESULT indiquées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
Un appel interne à GdiFlush a retourné une erreur. |
|
Opération réussie. |
Notes
Si la valeur de la variable membre CBaseWindow::m_bNoRealize est FALSE (valeur par défaut), cette méthode sélectionne la palette et la réalise. Sinon, il sélectionne la palette mais ne s’en rend pas compte. L’objet ne supprime aucune palette précédente qu’il utilisait. L’appelant est responsable de la suppression des palettes.
N’importe quel thread peut appeler cette méthode en toute sécurité, pas seulement le thread propriétaire de la fenêtre. La fenêtre envoie un message privé à elle-même, ce qui déclenche un appel à la méthode CBaseWindow::OnPaletteChange .
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|