Interface IPicture (ocidl.h)

Gère un objet image et ses propriétés. Les objets Image fournissent une abstraction indépendante du langage pour les bitmaps, les icônes et les métafichiers. Comme avec l’objet de police standard, le système fournit une implémentation standard de l’objet image. Ses interfaces principales sont IPicture et IPictureDisp, cette dernière étant dérivée d’IDispatch pour fournir l’accès aux propriétés de l’image via Automation. Un objet image est créé avec OleCreatePictureIndirect.

L’objet image prend également en charge l’interface sortante IPropertyNotifySink, afin qu’un client puisse déterminer quand les propriétés de l’image changent. Étant donné que l’objet image prend en charge au moins une interface sortante, il implémente également IConnectionPointContainer et ses interfaces associées à cet effet.

L’objet image prend également en charge IPersistStream afin qu’il puisse s’enregistrer et se charger lui-même à partir d’un instance d’IStream. Un objet qui utilise un objet image en interne enregistre et charge normalement l’image dans le cadre de sa propre gestion de persistance. La fonction OleLoadPicture simplifie la création d’un objet image en fonction du contenu du flux.

Héritage

L’interface IPicture hérite de l’interface IUnknown. IPicture a également les types de membres suivants :

Méthodes

L’interface IPicture a ces méthodes.

IPicture ::get_Attributes Récupère l’ensemble actuel des attributs de bits de l’image.
IPicture ::get_CurDC Récupère le handle du contexte d’appareil actuel. Cette propriété est valide uniquement pour les images bitmap.
IPicture ::get_Handle Récupère le handle de l’image gérée dans cet objet image à un emplacement spécifié.
IPicture ::get_Height Récupère la hauteur actuelle de l’image dans l’objet image.
IPicture ::get_hPal Récupère une copie de la palette actuellement utilisée par l’objet image.
IPicture ::get_KeepOriginalFormat Récupère la valeur actuelle de la propriété KeepOriginalFormat de l’image.
IPicture ::get_Type Récupère le type actuel de l’image contenue dans l’objet image.
IPicture ::get_Width Récupère la largeur actuelle de l’image dans l’objet image.
IPicture ::P ictureChanged Avertit l’objet image que sa ressource image a changé. Cette méthode appelle uniquement IPropertyNotifySink ::OnChanged avec DISPID_PICT_HANDLE pour tous les récepteurs connectés.
IPicture ::p ut_KeepOriginalFormat Définit la valeur de la propriété KeepOriginalFormat de l’image.
IPicture ::Render Affiche (dessine) une partie spécifiée de l’image définie par le décalage (xSrc,ySrc) de l’image source et les dimensions à copier (cxSrc,xySrc).
IPicture ::SaveAsFile Enregistre les données de l’image dans un flux au même format que celui qu’il enregistrerait lui-même dans un fichier. Les bitmaps utilisent le format de fichier BMP, métafichiers le format WMF et icônes le format ICO.
IPicture ::SelectPicture Sélectionne une image bitmap dans un contexte d’appareil donné et retourne le contexte de l’appareil dans lequel l’image a été précédemment sélectionnée, ainsi que le handle GDI de l’image. Cette méthode fonctionne conjointement avec IPicture ::get_CurDC.
IPicture ::set_hPal Affecte une palette GDI à l’image contenue dans l’objet image.

Remarques

Chaque propriété de l’interface IPicture inclut une méthode get_PropertyName si la propriété prend en charge l’accès en lecture et une méthode put_PropertyName si la propriété prend en charge l’accès en écriture.

Propriété	Type	Accès	Description
Handle	OLE_HANDLE (int)	R	Handle Windows GDI de l’image
hPal	OLE_HANDLE (int)	L/E	Handle Windows de la palette utilisée par l’image.
Type	short	R	Type d’image (voir PICTYPE).
Largeur	OLE_XSIZE_HIMETRIC (long)	R	Largeur de l’image.
Hauteur	OLE_YSIZE_HIMETRIC (long)	R	Hauteur de l’image.
CurDC	HDC	R	Contexte de l’appareil actuel.
KeepOriginalFormat	BOOL	L/E	Si la valeur est TRUE, l’objet image conserve tout l’état d’origine de l’image en mémoire. Si la valeur est FALSE, tout état non applicable à l’ordinateur de l’utilisateur est ignoré.
Attributs	DWORD	R	Attributs de bits divers de l’image.

 

Implémentation OLE

Les objets Image fournissent une abstraction indépendante du langage pour les bitmaps, les icônes et les métafichiers. Comme avec l’objet de police standard, le système fournit une implémentation standard de l’objet image. Ses interfaces principales sont IPicture et IPictureDisp. Un objet image est créé avec OleCreatePictureIndirect et prend en charge les interfaces IPicture et IPictureDisp .

L’objet image fourni par OLE implémente la sémantique complète des interfaces IPicture et IPictureDisp .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IPictureDisp