Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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 MembersTypeDescription
idPROPIDInteger 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.
lengthULONGSize, in bytes, of the value array.
typeWORDInteger 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.
valueVOID *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

Community Additions

Show:
© 2014 Microsoft