La classe `CBitmap`

Article
10/12/2023

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 ignorée 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

CObject

CGdiObject

CBitmap

Spécifications

En-tête : afxwin.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 ignorée 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 ignorer 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 ignore la 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_CHECKBOXES
OBM_CLOSE
OBM_COMBO
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

Exemple MFC MDI
CGdiObject Classe
Graphique hiérarchique

Partager via

La classe CBitmap

Syntaxe

Membres

Constructeurs publics

Méthodes publiques

Opérateurs publics

Notes

Hiérarchie d'héritage

Spécifications

CBitmap::CBitmap

Notes

CBitmap::CreateBitmap

Paramètres

Valeur de retour

Notes

CBitmap::CreateBitmapIndirect

Paramètres

Valeur de retour

Notes

CBitmap::CreateCompatibleBitmap

Paramètres

Valeur de retour

Notes

CBitmap::CreateDiscardableBitmap

Paramètres

Valeur de retour

Notes

CBitmap::FromHandle

Paramètres

Valeur de retour

Notes

CBitmap::GetBitmap

Paramètres

Valeur de retour

Notes

CBitmap::GetBitmapBits

Paramètres

Valeur de retour

Notes

CBitmap::GetBitmapDimension

Valeur de retour

Notes

CBitmap::LoadBitmap

Paramètres

Valeur de retour

Notes

CBitmap::LoadMappedBitmap

Paramètres

Valeur de retour

Notes

CBitmap::LoadOEMBitmap

Paramètres

Valeur de retour

Notes

CBitmap::operator HBITMAP

Valeur de retour

Notes

CBitmap::SetBitmapBits

Paramètres

Valeur de retour

CBitmap::SetBitmapDimension

Paramètres

Valeur de retour

Notes

Voir aussi

Commentaires

Ressources supplémentaires

La classe `CBitmap`

`CBitmap::CBitmap`

`CBitmap::CreateBitmap`

`CBitmap::CreateBitmapIndirect`

`CBitmap::CreateCompatibleBitmap`

`CBitmap::CreateDiscardableBitmap`

`CBitmap::FromHandle`

`CBitmap::GetBitmap`

`CBitmap::GetBitmapBits`

`CBitmap::GetBitmapDimension`

`CBitmap::LoadBitmap`

`CBitmap::LoadMappedBitmap`

`CBitmap::LoadOEMBitmap`

`CBitmap::operator HBITMAP`

`CBitmap::SetBitmapBits`

`CBitmap::SetBitmapDimension`