Image::FromFile method (gdiplusheaders.h)
The Image::FromFile method creates an Image object based on a file.
Syntax
Image * FromFile(
[in] const WCHAR *filename,
[in] BOOL useEmbeddedColorManagement
);
Parameters
[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.
Remarks
You can create Image objects based on files of a variety of types including BMP, GIF, JPEG, PNG, TIFF, and EMF.
Requirements
| Requirement | Value |
|---|---|
| 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 |