GdipGetPropertyItem()

Resultat.i = GdipGetPropertyItem(*image, propId.i, propSize.i, *buffer.PropertyItem)

*image

[in] Pointeur sur un objet image. 

propId.i

[in] Nombre entier qui identifie la propriété à obtenir (type de metadata). 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.

propSize.i

[in] Taille en octets de la propriété à obtenir. Utilisez la fonction  GdipGetPropertyItemSize() pour déterminer cette taille.

*buffer.PropertyItem

[out] Pointeur de type PropertyItem qui pointe une zone mémoire qui recevra les éléments de la propriété à retrouver.

Cette fonction permet d'obtenir 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.

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, retrouve la taille des métadonnées (si elles existent) du nom de l'appareil utilisé pour acquérir l'image, retrouve la marque de l'appareil utilisé pour acquérir l'image, affiche l'image et la marque de l'appareil en dessous de l'image.

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.