Image::FromFile-Methode (gdiplusheaders.h)

Artikel
03/04/2024

Die Image::FromFile-Methode erstellt ein Image-Objekt basierend auf einer Datei.

Syntax

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

Parameter

[in] filename

Typ: const WCHAR*

Zeiger auf eine Breitzeichenzeichenfolge, die den Namen der Datei angibt.

[in] useEmbeddedColorManagement

Typ: BOOL

Optional. Boolescher Wert, der angibt, ob das neue Image-Objekt die Farbkorrektur gemäß den in die Bilddatei eingebetteten Farbverwaltungsinformationen anwendet. Eingebettete Informationen können ICC-Profile (International Color Consortium), Gammawerte und Chromitätsinformationen enthalten. TRUE gibt an, dass die Farbkorrektur aktiviert ist, und FALSE gibt an, dass die Farbkorrektur nicht aktiviert ist. Der Standardwert ist FALSE.

Rückgabewert

Typ: Image*

Diese Methode gibt einen Zeiger auf das neue Image-Objekt zurück.

Hinweise

Sie können Image-Objekte erstellen, die auf Dateien verschiedener Typen basieren, einschließlich BMP, GIF, JPEG, PNG, TIFF und EMF.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll