Image::FromFile method (gdiplusheaders.h)

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


Image * FromFile(
  [in] const WCHAR *filename,
  [in] BOOL        useEmbeddedColorManagement


[in] filename

Type: const WCHAR*

Pointer to a wide-character string that specifies the name of the file.

[in] useEmbeddedColorManagement

Type: BOOL

Optional. Boolean value that specifies whether the new Image object applies color correction according to color management information that is embedded in the image file. Embedded information can include International Color Consortium (ICC) profiles, gamma values, and chromaticity information. TRUE specifies that color correction is enabled, and FALSE specifies that color correction is not enabled. The default value is FALSE.

Return value

Type: Image*

This method returns a pointer to the new Image object.


You can create Image objects based on files of a variety of types including BMP, GIF, JPEG, PNG, TIFF, and EMF.


Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header gdiplusheaders.h (include Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

See also


Drawing, Positioning, and Cloning Images


Image Constructors



Loading and Displaying Bitmaps