CPictureHolder, classe

Implémente une propriété Picture, qui permet à l’utilisateur d’afficher une image dans votre contrôle.

Syntaxe

class CPictureHolder

Membres

Constructeurs publics

Nom	Description
CPictureHolder ::CPictureHolder	Construit un objet CPictureHolder.

Méthodes publiques

Nom	Description
CPictureHolder ::CreateEmpty	Crée un objet CPictureHolder vide.
CPictureHolder ::CreateFromBitmap	Crée un CPictureHolder objet à partir d’une bitmap.
CPictureHolder ::CreateFromIcon	Crée un CPictureHolder objet à partir d’une icône.
CPictureHolder ::CreateFromMetafile	Crée un CPictureHolder objet à partir d’un métafichier.
CPictureHolder ::GetDisplayString	Récupère la chaîne affichée dans le navigateur de propriétés d’un conteneur de contrôle.
CPictureHolder ::GetPictureDispatch	Retourne l’interface de l’objet CPictureHolderIDispatch .
CPictureHolder ::GetType	Indique si l’objet CPictureHolder est une bitmap, un métafichier ou une icône.
CPictureHolder ::Render	Affiche l’image.
CPictureHolder ::SetPictureDispatch	Définit l’interface de l’objet CPictureHolderIDispatch .

Membres de données publics

Nom	Description
CPictureHolder ::m_pPict	Pointeur vers un objet image.

Notes

CPictureHolder n’a pas de classe de base.

Avec la propriété Picture stock, le développeur peut spécifier une image bitmap, une icône ou un métafichier pour l’affichage.

Pour plus d’informations sur la création de propriétés d’image personnalisées, consultez l’article MFC Contrôles ActiveX : Utilisation d’images dans un contrôle ActiveX.

Hiérarchie d'héritage

CPictureHolder

Spécifications

En-tête : afxctl.h

CPictureHolder ::CPictureHolder

Construit un objet CPictureHolder.

CPictureHolder();

CPictureHolder ::CreateEmpty

Crée un objet vide CPictureHolder et le connecte à une IPicture interface.

BOOL CreateEmpty();

Valeur de retour

Différent de zéro si l’objet est correctement créé ; sinon 0.

CPictureHolder ::CreateFromBitmap

Utilise une bitmap pour initialiser l’objet image dans un CPictureHolder.

BOOL CreateFromBitmap(
    UINT idResource);

BOOL CreateFromBitmap(
    CBitmap* pBitmap,
    CPalette* pPal = NULL,
    BOOL bTransferOwnership = TRUE);

BOOL CreateFromBitmap(
    HBITMAP hbm,
    HPALETTE hpal = NULL,
    BOOL bTransferOwnership = FALSE);

Paramètres

idResource
ID de ressource d’une ressource bitmap.

pBitmap
Pointeur vers un objet CBitmap .

pPal
Pointeur vers un objet CPalette .

bTransferOwnership
Indique si l’objet image prend possession des objets bitmap et palette.

Hbm
Handle vers la bitmap à partir de laquelle l’objet CPictureHolder est créé.

hpal
Handle vers la palette utilisée pour le rendu de la bitmap.

Valeur de retour

Différent de zéro si l’objet est correctement créé ; sinon 0.

Notes

Si bTransferOwnership a la valeur TRUE, l’appelant ne doit pas utiliser l’objet bitmap ou palette d’une manière quelconque une fois cet appel retourné. Si bTransferOwnership a la valeur FALSE, l’appelant est chargé de s’assurer que les objets bitmap et palette restent valides pendant toute la durée de vie de l’objet image.

CPictureHolder ::CreateFromIcon

Utilise une icône pour initialiser l’objet image dans un CPictureHolder.

BOOL CreateFromIcon(
    UINT idResource);

BOOL CreateFromIcon(
    HICON hIcon,
    BOOL bTransferOwnership = FALSE);

Paramètres

idResource
ID de ressource d’une ressource bitmap.

hIcon
Handle vers l’icône à partir de laquelle l’objet CPictureHolder est créé.

bTransferOwnership
Indique si l’objet image prend possession de l’objet icône.

Valeur de retour

Différent de zéro si l’objet est correctement créé ; sinon 0.

Notes

Si bTransferOwnership a la valeur TRUE, l’appelant ne doit pas utiliser l’objet d’icône d’une manière quelconque une fois cet appel retourné. Si bTransferOwnership a la valeur FALSE, l’appelant est chargé de s’assurer que l’objet icône reste valide pendant la durée de vie de l’objet image.

CPictureHolder ::CreateFromMetafile

Utilise un métafichier pour initialiser l’objet image dans un CPictureHolder.

BOOL CreateFromMetafile(
    HMETAFILE hmf,
    int xExt,
    int yExt,
    BOOL bTransferOwnership = FALSE);

Paramètres

Hmf
Handle vers le métafichier utilisé pour créer l’objet CPictureHolder .

xExt
Étendue X de l’image.

yExt
Étendue Y de l’image.

bTransferOwnership
Indique si l’objet image prend possession de l’objet métafichier.

Valeur de retour

Différent de zéro si l’objet est correctement créé ; sinon 0.

Notes

Si bTransferOwnership a la valeur TRUE, l’appelant ne doit pas utiliser l’objet de métafichier d’une manière quelconque après que cet appel est retourné. Si bTransferOwnership a la valeur FALSE, l’appelant est chargé de s’assurer que l’objet de métafichier reste valide pendant la durée de vie de l’objet image.

CPictureHolder ::GetDisplayString

Récupère la chaîne affichée dans le navigateur de propriétés d’un conteneur.

BOOL GetDisplayString(CString& strValue);

Paramètres

strValue
Référence à la chaîne CString qui doit contenir la chaîne d’affichage.

Valeur de retour

Différent de zéro si la chaîne est récupérée avec succès ; sinon 0.

CPictureHolder ::GetPictureDispatch

Cette fonction retourne un pointeur vers l’interface de l’objet CPictureHolderIPictureDisp .

LPPICTUREDISP GetPictureDispatch();

Valeur de retour

Pointeur vers l’interface de l’objet CPictureHolderIPictureDisp .

Notes

L’appelant doit appeler Release ce pointeur une fois terminé.

CPictureHolder ::GetType

Indique si l’image est une bitmap, un métafichier ou une icône.

short GetType();

Valeur de retour

Valeur indiquant le type de l’image. Les valeurs possibles et leurs significations sont les suivantes :

Value	Signification
PICTYPE_UNINITIALIZED	CPictureHolder l’objet est unitaire.
PICTYPE_NONE	CPictureHolder l’objet est vide.
PICTYPE_BITMAP	L’image est une bitmap.
PICTYPE_METAFILE	L’image est un métafichier.
PICTYPE_ICON	L’image est une icône.

CPictureHolder ::m_pPict

Pointeur vers l’interface de l’objet CPictureHolderIPicture .

LPPICTURE m_pPict;

CPictureHolder ::Render

Affiche l’image dans le rectangle référencé par rcRender.

void Render(
    CDC* pDC,
    const CRect& rcRender,
    const CRect& rcWBounds);

Paramètres

pDC
Pointeur vers le contexte d’affichage dans lequel l’image doit être affichée.

rcRender
Rectangle dans lequel l’image doit être affichée.

rcWBounds
Rectangle représentant le rectangle englobant de l’objet qui affiche l’image. Pour un contrôle, ce rectangle est le paramètre rcBounds passé à un remplacement de COleControl ::OnDraw.

CPictureHolder ::SetPictureDispatch

Connecter l’objet CPictureHolder vers une IPictureDisp interface.

void SetPictureDispatch(LPPICTUREDISP pDisp);

Paramètres

pDisp
Pointeur vers la nouvelle IPictureDisp interface.

Voir aussi

Graphique hiérarchique
CFontHolder, classe