IShellImageData interface
[This interface will eventually be unsupported. It is recommended that Windows GDI+ APIs be used in place of IShellImageData methods.]
Exposes methods and properties that display, manipulate, and describe image data.
Members
The IShellImageData interface inherits from the IUnknown interface. IShellImageData also has these types of members:
Methods
The IShellImageData interface has these methods.
| Method | Description |
|---|---|
| CloneFrame |
Retrieves a clone of the current image or frame. |
| Decode |
Decodes the image file, setting state. |
| DiscardEdit |
Discards edits made to an image. |
| DisplayName |
Gets the name of the file if IShellImageData was initialized on a file path. Otherwise, gets the name of the data stream. |
| Draw |
Draws a decoded image. |
| GetCurrentPage |
Gets the current page of a multipage image. |
| GetDelay |
Gets the delay value for the current frame of an animation. |
| GetEncoderParams |
Gets the current set of encoder parameters. |
| GetPageCount |
Gets the number of pages in a multipage image. |
| GetPixelFormat |
Gets the pixel format of the image. |
| GetProperties |
Gets an IPropertySetStorage through which the properties of the image can be accessed. |
| GetRawDataFormat |
Retrieves a GUID that identifies the format of the image. |
| GetResolution |
Gets the resolution, in dpi, of the image. |
| GetSize |
Gets the dimensions of the image file. |
| IsAnimated |
Determines whether the image is animated. |
| IsDecoded |
Determines whether the image has been decoded by calling IShellImageData::Decode. Many operations return a failure code if the image is not first decoded. |
| IsEditable |
Determines whether the image can be edited. |
| IsMultipage |
Determines whether the image is a multipage TIFF image. |
| IsPrintable |
Determines whether the image can be printed. |
| IsTransparent |
Determines whether the image is transparent. |
| IsVector |
Determines whether the image is a vector image. |
| NextFrame |
Switches to the next frame of an animated image. |
| NextPage |
Switches to the next page of a multipage image. Any associated animations are reset. |
| PrevPage |
Switches to the previous page of a multipage image. Any associated animations are reset. |
| RegisterAbort |
Sets a callback abort object, optionally returning a pointer to the previous object. |
| ReplaceFrame |
Replaces the current frame with a new image. |
| Rotate |
Rotates an image in increments of 90 degrees. |
| Scale |
Adjusts the size of an image. |
| SelectPage |
Selects a specified page in a multipage image. |
| SetEncoderParams |
Sets encoder parameters. |
Remarks
This interface was not included in a public header file prior to Windows Vista.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
IDL |
|
|
DLL |
|