PropertyItem class

Applies to: desktop apps only

The PropertyItem class is a helper class for the Image and Bitmap classes. A PropertyItem object holds one piece of image metadata.

PropertyItem has these types of members:

Data Members

The following table lists the members exposed by the PropertyItem object.

Data Members Type Description
id PROPID Integer that identifies the kind of metadata stored in this PropertyItem object. Constants that identify various kinds of metadata (PropertyTagEquipMake, PropertyTagEquipModel, and the like) are defined in Gdiplusimaging.h. The PROPID data type is defined in Wtypes.h.
length ULONG Size, in bytes, of the value array.
type WORD Integer that identifies the data type of the values in the value array. Constants that identify various data types (PropertyTagTypeByte, PropertyTagTypeASCII, and the like) are defined in Gdiplusimaging.h.
value VOID * Pointer to an array of values. Each value in the array has the data type specified by the type data member.

 

Remarks

To set a property item (piece of metadata), pass the address of a PropertyItem object to the Image::SetPropertyItem method of an Image object. To retrieve a property item, pass the address of a PropertyItem object to the Image::GetPropertyItem method of an Image object.

Requirements

Minimum supported client

Windows XP, Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Product

GDI+ 1.0

Header

Gdiplusimaging.h (include Gdiplus.h)

Library

Gdiplus.lib

See also

Image::GetAllPropertyItems

Image::GetPropertyIdList

Image::GetPropertyItem

Image::GetPropertyItemSize

Image::GetPropertySize

Image::RemovePropertyItem

Image::SetPropertyItem

Reading and Writing Metadata

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012