La classe CBitmap
Encapsule une bitmap GDI (Graphics Device Interface) Windows et fournit des fonctions membres pour la manipuler.
Syntaxe
class CBitmap : public CGdiObject
Membres
Constructeurs publics
| Nom | Description |
|---|---|
CBitmap::CBitmap |
Construit un objet CBitmap. |
Méthodes publiques
| Nom | Description |
|---|---|
CBitmap::CreateBitmap |
Initialise l’objet avec une bitmap de mémoire dépendante de l’appareil qui a une largeur, une hauteur et un modèle de bits spécifiés. |
CBitmap::CreateBitmapIndirect |
Initialise l’objet avec une bitmap avec la largeur, la hauteur et le modèle de bits (si l’un est spécifié) donné dans une BITMAP structure. |
CBitmap::CreateCompatibleBitmap |
Initialise l’objet avec une bitmap afin qu’il soit compatible avec un appareil spécifié. |
CBitmap::CreateDiscardableBitmap |
Initialise l’objet avec une bitmap dis carte able compatible avec un appareil spécifié. |
CBitmap::FromHandle |
Retourne un pointeur vers un CBitmap objet lorsqu’un handle est donné à une bitmap Windows HBITMAP . |
CBitmap::GetBitmap |
Remplit une BITMAP structure avec des informations sur la bitmap. |
CBitmap::GetBitmapBits |
Copie les bits de la bitmap spécifiée dans la mémoire tampon spécifiée. |
CBitmap::GetBitmapDimension |
Retourne la largeur et la hauteur de la bitmap. La hauteur et la largeur sont supposées avoir été définies précédemment par la SetBitmapDimension fonction membre. |
CBitmap::LoadBitmap |
Initialise l’objet en chargeant une ressource bitmap nommée à partir du fichier exécutable de l’application et en attachant la bitmap à l’objet. |
CBitmap::LoadMappedBitmap |
Charge une bitmap et mappe les couleurs aux couleurs système actuelles. |
CBitmap::LoadOEMBitmap |
Initialise l’objet en chargeant une bitmap Windows prédéfinie et en attachant la bitmap à l’objet. |
CBitmap::SetBitmapBits |
Définit les bits d’une bitmap sur les valeurs de bits spécifiées. |
CBitmap::SetBitmapDimension |
Affecte une largeur et une hauteur à une bitmap en unités de 0,1 millimètre. |
Opérateurs publics
| Nom | Description |
|---|---|
CBitmap::operator HBITMAP |
Retourne le handle Windows attaché à l’objet CBitmap . |
Notes
Pour utiliser un CBitmap objet, construisez l’objet, attachez un handle bitmap à celui-ci avec l’une des fonctions membres d’initialisation, puis appelez les fonctions membres de l’objet.
Pour plus d’informations sur l’utilisation d’objets graphiques tels que CBitmap, consultez Objets graphiques.
Hiérarchie d'héritage
CBitmap
Spécifications
En-têteafxwin.h:
CBitmap::CBitmap
Construit un objet CBitmap.
CBitmap();
Notes
L’objet résultant doit être initialisé avec l’une des fonctions membres d’initialisation.
CBitmap::CreateBitmap
Initialise une image bitmap de mémoire dépendante de l’appareil avec la largeur, la hauteur et le modèle binaire spécifiés.
BOOL CreateBitmap(
int nWidth,
int nHeight,
UINT nPlanes,
UINT nBitcount,
const void* lpBits);
Paramètres
nWidth
Spécifie la largeur (en pixels) de l’image bitmap.
nHeight
Spécifie la hauteur (en pixels) de l’image bitmap.
nPlanes
Spécifie le nombre de plans de couleur de l’image bitmap.
nBitcount
Spécifie le nombre de bits de couleur par pixel d’affichage.
lpBits
Pointe vers un tableau d’octets qui contient les valeurs de bit de l’image bitmap initiale. Si c’est NULLle cas, la nouvelle bitmap est laissée non initialisée.
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Notes
Pour une image bitmap de couleur, le paramètre nPlanes ou nBitcount doit être défini avec la valeur 1. Si ces deux paramètres sont définis avec la valeur 1, CreateBitmap crée une image bitmap monochrome.
Bien qu’une bitmap ne puisse pas être sélectionnée directement pour un appareil d’affichage, elle peut être sélectionnée comme bitmap actuelle pour un « contexte d’appareil mémoire » à l’aide CDC::SelectObject et copiée dans n’importe quel contexte d’appareil compatible à l’aide de la CDC::BitBlt fonction.
Quand vous en avez terminé avec l’objet CBitmap créé par la fonction CreateBitmap , commencez par sélectionner l’image bitmap hors du contexte de périphérique, puis supprimez l’objet CBitmap .
Pour plus d’informations, consultez la description du bmBits champ dans la BITMAP structure. La BITMAP structure est décrite sous la CBitmap::CreateBitmapIndirect fonction membre.
CBitmap::CreateBitmapIndirect
Initialise une bitmap qui a la largeur, la hauteur et le modèle de bits (si l’un est spécifié) donné dans la structure pointée par lpBitmap.
BOOL CreateBitmapIndirect(LPBITMAP lpBitmap);
Paramètres
lpBitmap
Pointe vers une BITMAP structure qui contient des informations sur la bitmap.
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Notes
Bien qu’une bitmap ne puisse pas être sélectionnée directement pour un appareil d’affichage, elle peut être sélectionnée comme bitmap actuelle pour un contexte d’appareil mémoire en utilisant CDC::SelectObject et copiée dans n’importe quel contexte d’appareil compatible à l’aide de la ou CDC::StretchBlt de la CDC::BitBlt fonction. (La CDC::PatBlt fonction peut copier la bitmap du pinceau actuel directement dans le contexte de l’appareil d’affichage.)
Si la BITMAP structure pointée par le lpBitmap paramètre a été remplie à l’aide de la GetObject fonction, les bits de la bitmap ne sont pas spécifiés et la bitmap n’est pas initialisée. Pour initialiser la bitmap, une application peut utiliser une fonction telle que CDC::BitBlt ou SetDIBits pour copier les bits de la bitmap identifiée par le premier paramètre de CGdiObject::GetObject la bitmap créée par CreateBitmapIndirect.
Lorsque vous avez terminé avec l’objet CBitmap créé avec CreateBitmapIndirect la fonction, sélectionnez d’abord la bitmap hors du contexte de l’appareil, puis supprimez l’objet CBitmap .
CBitmap::CreateCompatibleBitmap
Initialise une bitmap compatible avec l’appareil spécifié par pDC.
BOOL CreateCompatibleBitmap(
CDC* pDC,
int nWidth,
int nHeight);
Paramètres
pDC
Spécifie le contexte de l’appareil.
nWidth
Spécifie la largeur (en pixels) de l’image bitmap.
nHeight
Spécifie la hauteur (en pixels) de l’image bitmap.
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Notes
La bitmap a le même nombre de plans de couleurs ou le même format bits par pixel que le contexte d’appareil spécifié. Il peut être sélectionné comme bitmap actuelle pour n’importe quel appareil mémoire compatible avec celui spécifié par pDC.
S’il pDC s’agit d’un contexte d’appareil mémoire, la bitmap retournée a le même format que la bitmap actuellement sélectionnée dans ce contexte d’appareil. Un « contexte d’appareil mémoire » est un bloc de mémoire qui représente une surface d’affichage. Il peut être utilisé pour préparer des images en mémoire avant de les copier dans la surface d’affichage réelle de l’appareil compatible.
Lorsqu’un contexte d’appareil mémoire est créé, GDI sélectionne automatiquement une bitmap de stock monochrome pour celle-ci.
Étant donné qu’un contexte d’appareil de mémoire de couleur peut avoir sélectionné des bitmaps de couleur ou monochromes, le format de la bitmap retournée par la CreateCompatibleBitmap fonction n’est pas toujours le même ; toutefois, le format d’une bitmap compatible pour un contexte d’appareil non-mémoire est toujours au format de l’appareil.
Lorsque vous avez terminé avec l’objet CBitmap créé avec la CreateCompatibleBitmap fonction, sélectionnez d’abord la bitmap hors du contexte de l’appareil, puis supprimez l’objet CBitmap .
CBitmap::CreateDiscardableBitmap
Initialise une bitmap dis carte able compatible avec le contexte de l’appareil identifié par pDC.
BOOL CreateDiscardableBitmap(
CDC* pDC,
int nWidth,
int nHeight);
Paramètres
pDC
Spécifie un contexte d’appareil.
nWidth
Spécifie la largeur (en bits) de la bitmap.
nHeight
Spécifie la hauteur (en bits) de la bitmap.
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Notes
La bitmap a le même nombre de plans de couleurs ou le même format bits par pixel que le contexte d’appareil spécifié. Une application peut sélectionner cette bitmap comme bitmap actuelle pour un appareil mémoire compatible avec celui spécifié par pDC.
Windows peut dis carte une bitmap créée par cette fonction uniquement si une application ne l’a pas sélectionnée dans un contexte d’affichage. Si Windows dés carte l’image bitmap lorsqu’elle n’est pas sélectionnée et que l’application tente ultérieurement de la sélectionner, la CDC::SelectObject fonction retourne NULL.
Lorsque vous avez terminé avec l’objet CBitmap créé avec la CreateDiscardableBitmap fonction, sélectionnez d’abord la bitmap hors du contexte de l’appareil, puis supprimez l’objet CBitmap .
CBitmap::FromHandle
Retourne un pointeur vers un CBitmap objet lorsqu’un handle est donné à une bitmap GDI Windows.
static CBitmap* PASCAL FromHandle(HBITMAP hBitmap);
Paramètres
hBitmap
Spécifie une bitmap GDI Windows.
Valeur de retour
Pointeur vers un CBitmap objet en cas de réussite ; sinon NULL.
Notes
Si un CBitmap objet n’est pas déjà attaché au handle, un objet temporaire CBitmap est créé et attaché. Cet objet temporaire CBitmap est valide uniquement jusqu’à la prochaine fois que l’application a un temps d’inactivité dans sa boucle d’événements, auquel cas tous les objets graphiques temporaires sont supprimés. Une autre façon de dire ceci est que l’objet temporaire n’est valide que pendant le traitement d’un message de fenêtre.
CBitmap::GetBitmap
Récupère les propriétés d’image pour la bitmap jointe.
int GetBitmap(BITMAP* pBitMap);
Paramètres
pBitMap
Pointeur vers une BITMAP structure qui recevra les propriétés de l’image. Ce paramètre ne doit pas être NULL.
Valeur de retour
Différent de zéro si la méthode a réussi ; sinon 0.
Notes
CBitmap::GetBitmapBits
Copie le modèle de bits de la bitmap jointe dans la mémoire tampon spécifiée.
DWORD GetBitmapBits(
DWORD dwCount,
LPVOID lpBits) const;
Paramètres
dwCount
Nombre d’octets à copier dans la mémoire tampon.
lpBits
Pointeur vers la mémoire tampon qui recevra la bitmap.
Valeur de retour
Nombre d’octets copiés dans la mémoire tampon si la méthode a réussi ; sinon 0.
Notes
Permet CBitmap::GetBitmap de déterminer la taille de mémoire tampon requise.
CBitmap::GetBitmapDimension
Retourne la largeur et la hauteur de la bitmap.
CSize GetBitmapDimension() const;
Valeur de retour
Largeur et hauteur de la bitmap, mesurées en unités de 0,1 millimètre. La hauteur se trouve dans le cy membre de l’objet CSize , et la largeur se trouve dans le cx membre. Si la largeur et la hauteur bitmap n’ont pas été définies à l’aide SetBitmapDimensionde , la valeur de retour est 0.
Notes
La hauteur et la largeur sont supposées avoir été définies précédemment à l’aide de la SetBitmapDimension fonction membre.
CBitmap::LoadBitmap
Charge la ressource bitmap nommée par lpszResourceName ou identifiée par le numéro d’ID dans nIDResource le fichier exécutable de l’application.
BOOL LoadBitmap(LPCTSTR lpszResourceName);
BOOL LoadBitmap(UINT nIDResource);
Paramètres
lpszResourceName
Pointe vers une chaîne terminée par null qui contient le nom de la ressource bitmap.
nIDResource
Spécifie le numéro d’ID de ressource de la ressource bitmap.
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Notes
La bitmap chargée est attachée à l’objet CBitmap .
Si la bitmap identifiée par lpszResourceName n’existe pas ou si la mémoire est insuffisante pour charger la bitmap, la fonction retourne 0.
Vous pouvez utiliser la fonction pour supprimer la CGdiObject::DeleteObject bitmap chargée par la LoadBitmap fonction, ou le CBitmap destructeur supprime l’objet pour vous.
Attention
Avant de supprimer l’objet, vérifiez qu’il n’est pas sélectionné dans un contexte d’appareil.
Les bitmaps suivantes ont été ajoutées aux versions 3.1 et ultérieures de Windows :
OBM_UPARRROWIOBM_DNARROWIOBM_RGARROWIOBM_LFARROWI
Ces bitmaps sont introuvables dans les pilotes de périphérique pour les versions 3.0 et antérieures de Windows. Pour obtenir la liste complète des bitmaps et un affichage de leur apparence, consultez le Kit de développement logiciel (SDK) Windows.
CBitmap::LoadMappedBitmap
Appelez cette fonction membre pour charger une bitmap et mapper les couleurs aux couleurs système actuelles.
BOOL LoadMappedBitmap(
UINT nIDBitmap,
UINT nFlags = 0,
LPCOLORMAP lpColorMap = NULL,
int nMapSize = 0);
Paramètres
nIDBitmap
ID de la ressource bitmap.
nFlags
Indicateur pour une bitmap. Peut être égal à zéro ou CMB_MASKED.
lpColorMap
Pointeur vers une COLORMAP structure qui contient les informations de couleur nécessaires pour mapper les bitmaps. Si ce paramètre est NULLle cas, la fonction utilise la carte de couleurs par défaut.
nMapSize
Nombre de cartes de couleurs pointées par lpColorMap.
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Notes
Par défaut, LoadMappedBitmap mappe les couleurs couramment utilisées dans les glyphes de bouton.
Pour plus d’informations sur la création d’une bitmap mappée, consultez la fonction CreateMappedBitmap Windows et la COLORMAP structure dans le Kit de développement logiciel (SDK) Windows.
CBitmap::LoadOEMBitmap
Charge une bitmap prédéfinie utilisée par Windows.
BOOL LoadOEMBitmap(UINT nIDBitmap);
Paramètres
nIDBitmap
Numéro d’ID de la bitmap Windows prédéfinie. Les valeurs possibles sont répertoriées ci-dessous à partir de WINDOWS.H:
OBM_BTNCORNERS
OBM_BTSIZE
OBM_CHECK
OBM_CHECKo OXES
OBM_CLOSE
OBM_COMo O
OBM_DNARROW
OBM_DNARROWD
OBM_DNARROWI
OBM_LFARROW
OBM_LFARROWD
OBM_LFARROWI
OBM_MNARROW
OBM_OLD_CLOSE
OBM_OLD_DNARROW
OBM_OLD_LFARROW
OBM_OLD_REDUCE
OBM_OLD_RESTORE
OBM_OLD_RGARROW
OBM_OLD_UPARROW
OBM_OLD_ZOOM
OBM_REDUCE
OBM_REDUCED
OBM_RESTORE
OBM_RESTORED
OBM_RGARROW
OBM_RGARROWD
OBM_RGARROWI
OBM_SIZE
OBM_UPARROW
OBM_UPARROW
OBM_UPARROWD
OBM_ZOOM
OBM_ZOOMD
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Notes
Les noms bitmap commençant OBM_OLD par représenter des bitmaps utilisées par les versions de Windows antérieures à la version 3.0.
Notez que la constante OEMRESOURCE doit être définie avant d’inclure WINDOWS.H afin d’utiliser l’une OBM_ des constantes.
CBitmap::operator HBITMAP
Utilisez cet opérateur pour obtenir le handle GDI Windows attaché de l’objet CBitmap .
operator HBITMAP() const;
Valeur de retour
En cas de réussite, un handle vers l’objet GDI Windows représenté par l’objet CBitmap ; sinon NULL.
Notes
Cet opérateur est un opérateur de cast, qui prend en charge l’utilisation directe d’un HBITMAP objet.
Pour plus d’informations sur l’utilisation d’objets graphiques, consultez Objets graphiques dans le Kit de développement logiciel (SDK) Windows.
CBitmap::SetBitmapBits
Définit les bits d’une bitmap sur les valeurs de bits données par lpBits.
DWORD SetBitmapBits(
DWORD dwCount,
const void* lpBits);
Paramètres
dwCount
Spécifie le nombre d’octets pointés par lpBits.
lpBits
Pointe vers le BYTE tableau qui contient les valeurs de pixel à copier dans l’objet CBitmap . Pour que la bitmap puisse afficher correctement son image, les valeurs doivent être mises en forme pour être conformes aux valeurs de hauteur, de largeur et de profondeur de couleur spécifiées lors de la création de l’instance CBitmap . Pour plus d’informations, consultez CBitmap::CreateBitmap.
Valeur de retour
Nombre d’octets utilisés pour définir les bits bitmap ; 0 si la fonction échoue.
CBitmap::SetBitmapDimension
Affecte une largeur et une hauteur à une bitmap en unités de 0,1 millimètre.
CSize SetBitmapDimension(
int nWidth,
int nHeight);
Paramètres
nWidth
Spécifie la largeur de la bitmap (en unités de 0,1 millimètre).
nHeight
Spécifie la hauteur de la bitmap (en unités de 0,1 millimètre).
Valeur de retour
Dimensions bitmap précédentes. La hauteur se trouve dans la cy variable membre de l’objet CSize , et la largeur se trouve dans la cx variable membre.
Notes
L’ID de groupe n’utilise pas ces valeurs, sauf pour les renvoyer lorsqu’une application appelle la GetBitmapDimension fonction membre.
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour