Image.Image(const WCHAR*, BOOL) constructor

Applies to: desktop apps only

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

Syntax

Image(
  [in]  const WCHAR *filename,
  [in]  BOOL useEmbeddedColorManagement = FALSE
);

Parameters

filename [in]

Type: const WCHAR*

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

useEmbeddedColorManagement [in]

Type: BOOL

Optional. Boolean value that specifies whether the new Image::Image object applies color correction according to color management information that is embedded in the image file. Embedded information can include ICC profiles, gamma values, and chromaticity information.

FALSE

Default. Specifies that color correction is enabled

TRUE

Specifies that color correction is not enabled

Remarks

You can construct Image::Image objects based on files of a variety of types including BMP, Graphics Interchange Format (GIF), JPEG, PNG, TIFF, and EMF.

Requirements

Minimum supported client

Windows XP, Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Product

GDI+ 1.0

Header

Gdiplusheaders.h (include Gdiplus.h)

Library

Gdiplus.lib

DLL

Gdiplus.dll

See also

Image

Bitmap

Image::Clone

Image::FromFile

Image::FromStream

Image Constructors

Loading and Displaying Bitmaps

Drawing, Positioning, and Cloning Images

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012