Export (0) Print
Expand All

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

ADD
Show:
© 2014 Microsoft