GdipSetPropertyItem()

Resultat.i = GdipSetPropertyItem(*image, *item.PropertyItem)

*image

[in] Pointeur sur un objet image. 

*item.PropertyItem

[in] Variable de type PropertyItem qui recevra l'élément de la propriété à modifier.

Cette fonction permet de modifier une information spécifique stockée dans une image. Cette information est aussi appelée propriété.
Les propriétés sont des informations comme la marque ou le modèle de l'appareil photo utilisé pour la capture de l'image. Chaque propriété est identifiée par une balise (ou tag) qui est un élément de l'énumération Image property ID tags.

Les valeurs retrouvées qui ont le paramètre wtype (PropertyItem) valant #PropertyTagTypeASCII sont des chaînes au format ASCII.

Certains formats images (par exemple les ICON ou EMF) ne supportent pas les propriétés. Si vous utilisez cette fonction avec une image qui ne supporte pas les propriétés, elle retournera #PropertyNotSupported.

PropertyItem défini les éléments suivants :

id.i

Nombre entier qui identifie le type de metadata stocké. Les constantes qui identifient les différents types de metadata (#PropertyTagEquipMake, #PropertyTagEquipModel, etc.) sont des éléments de l'énumération Image property ID tags. Id est de type PROPID (long non signé) et est défini dans le fichier WTypes.h.

length.i

Taille en octets du tableau de valeurs pointé par *value.

wtype.w

Nombre entier qui identifie le type de données du tableau de valeurs pointé par *value. Les constantes qui identifient les divers types de propriétés d'images (#PropertyTagTypeByte, #PropertyTagTypeASCII, etc.) sont des éléments de l'énumération Image property types.

*value

Pointeur sur un tableau de valeurs. Chaque valeur du tableau a le type de données (data type) spécifié par l'élément wtype.w.

L'exemple charge une image jpg, modifie le titre de l'image (Une rose), retrouve ce titre modifié et l'affiche en dessous de l'image.

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si l'image ne supporte pas les propriétés, la fonction retournera #PropertyNotSupported.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.