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

Méthodes publiques

Membres de données publics

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 CPictureHolder IPictureDisp .

LPPICTUREDISP GetPictureDispatch();

Valeur de retour

Pointeur vers l’interface de l’objet CPictureHolder IPictureDisp .

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 :

CPictureHolder ::m_pPict

Pointeur vers l’interface de l’objet CPictureHolder IPicture .

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

Connecte l’objet CPictureHolder à une IPictureDisp interface.

void SetPictureDispatch(LPPICTUREDISP pDisp);

Paramètres

pDisp
Pointeur vers la nouvelle IPictureDisp interface.

Voir aussi

Graphique hiérarchique
CFontHolder, classe