Windows Dev Center

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.

Image class

Applies to: desktop apps only

The Image class provides methods for loading and saving raster images (bitmaps) and vector images (metafiles). An Image object encapsulates a bitmap or a metafile and stores attributes that you can retrieve by calling various Get methods. You can construct Image objects from a variety of file types including BMP, ICON, GIF, JPEG, Exif, PNG, TIFF, WMF, and EMF.

Members

The Image class inherits from GdiplusBase. Image also has these types of members:

Constructors

The Image class has these constructors.

ConstructorDescription
Image::Image(IStream*,BOOL)

Creates an Image::Image object based on a stream.

Image::Image(WCHAR*,BOOL)

Creates an Image::Image object based on a file.

 

Methods

The Image class has these methods.

MethodDescription
Image::Clone

The Image::Clone method creates a new Image object and initializes it with the contents of this Image object.

Image::FindFirstItem

The Image::FindFirstItem method retrieves the description and the data size of the first metadata item in this Image object.

Image::FindNextItem

The Image::FindNextItem method is used along with the Image::FindFirstItem method to enumerate the metadata items stored in this Image object. The Image::FindNextItem method retrieves the description and the data size of the next metadata item in this Image object.

Image::FromFile

The Image::FromFile method creates an Image object based on a file.

Image::FromStream

The Image::FromStream method creates a new Image object based on a stream.

Image::GetAllPropertyItems

The Image::GetAllPropertyItems method gets all the property items (metadata) stored in this Image object.

Image::GetBounds

The Image::GetBounds method gets the bounding rectangle for this image.

Image::GetEncoderParameterList

The Image::GetEncoderParameterList method gets a list of the parameters supported by a specified image encoder.

Image::GetEncoderParameterListSize

The Image::GetEncoderParameterListSize method gets the size, in bytes, of the parameter list for a specified image encoder.

Image::GetFlags

The Image::GetFlags method gets a set of flags that indicate certain attributes of this Image object.

Image::GetFrameCount

The Image::GetFrameCount method gets the number of frames in a specified dimension of this Image object.

Image::GetFrameDimensionsCount

The Image::GetFrameDimensionsCount method gets the number of frame dimensions in this Image object.

Image::GetFrameDimensionsList

The Image::GetFrameDimensionsList method gets the identifiers for the frame dimensions of this Image object.

Image::GetHeight

The Image::GetHeight method gets the image height, in pixels, of this image.

Image::GetHorizontalResolution

The Image::GetHorizontalResolution method gets the horizontal resolution, in dots per inch, of this image.

Image::GetItemData

The Image::GetItemData method gets one piece of metadata from this Image object.

Image::GetLastStatus

The Image::GetLastStatus method returns a value that indicates the nature of this Image object's most recent method failure.

Image::GetPalette

The Image::GetPalette method gets the ColorPalette of this Image object.

Image::GetPaletteSize

The Image::GetPaletteSize method gets the size, in bytes, of the color palette of this Image object.

Image::GetPhysicalDimension

The Image::GetPhysicalDimension method gets the width and height of this image.

Image::GetPixelFormat

The Image::GetPixelFormat method gets the pixel format of this Image object.

Image::GetPropertyCount

The Image::GetPropertyCount method gets the number of properties (pieces of metadata) stored in this Image object.

Image::GetPropertyIdList

The Image::GetPropertyIdList method gets a list of the property identifiers used in the metadata of this Image object.

Image::GetPropertyItem

The Image::GetPropertyItem method gets a specified property item (piece of metadata) from this Image object.

Image::GetPropertyItemSize

The Image::GetPropertyItemSize method gets the size, in bytes, of a specified property item of this Image object.

Image::GetPropertySize

The Image::GetPropertySize method gets the total size, in bytes, of all the property items stored in this Image object. The Image::GetPropertySize method also gets the number of property items stored in this Image object.

Image::GetRawFormat

The Image::GetRawFormat method gets a globally unique identifier ( GUID) that identifies the format of this Image object. GUIDs that identify various file formats are defined in Gdiplusimaging.h.

Image::GetThumbnailImage

The Image::GetThumbnailImage method gets a thumbnail image from this Image object.

Image::GetType

The Image::GetType method gets the type (bitmap or metafile) of this Image object.

Image::GetVerticalResolution

The Image::GetVerticalResolution method gets the vertical resolution, in dots per inch, of this image.

Image::GetWidth

The Image::GetWidth method gets the width, in pixels, of this image.

Image::RemovePropertyItem

The Image::RemovePropertyItem method removes a property item (piece of metadata) from this Image object.

Image::RotateFlip

The Image::RotateFlip method rotates and flips this image.

Image::Save(IStream*,CLSID*,EncoderParameters*)

The Image::Save method saves this image to a stream.

Image::Save(WCHAR*,CLSID*,EncoderParameters*)

The Image::Save method saves this image to a file.

Image::SaveAdd(EncoderParameters*)

The Image::SaveAdd method adds a frame to a file or stream specified in a previous call to the Save method. Use this method to save selected frames from a multiple-frame image to another multiple-frame image.

Image::SaveAdd(Image*,EncoderParameters*)

The Image::SaveAdd method adds a frame to a file or stream specified in a previous call to the Save method.

Image::SelectActiveFrame

The Image::SelectActiveFrame method selects the frame in this Image object specified by a dimension and an index.

Image::SetAbort

The Image::SetAbort method sets the object whose Abort method is called periodically during time-consuming rendering operation.

Image::SetPalette

The Image::SetPalette method sets the color palette of this Image object.

Image::SetPropertyItem

The Image::SetPropertyItem method sets a property item (piece of metadata) for this Image object. If the item already exists, then its contents are updated; otherwise, a new item is added.

 

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

Show:
© 2015 Microsoft