SetICMProfileA-Funktion (wingdi.h)
Die SetICMProfile-Funktion legt ein angegebenes Farbprofil als Ausgabeprofil für einen angegebenen Gerätekontext (Device Context, DC) fest.
Syntax
BOOL SetICMProfileA(
HDC hdc,
LPSTR lpFileName
);
Parameter
hdc
Gibt einen Gerätekontext an, in dem das Farbprofil festgelegt werden soll.
lpFileName
Gibt den Pfadnamen des festzulegenden Farbprofils an.
Rückgabewert
Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE.
Hinweise
SetICMProfile ordnet einem Gerätekontext ein Farbprofil zu. Es wird zum Ausgabeprofil für diesen Gerätekontext. Das Farbprofil muss keinem bestimmten Gerät zugeordnet werden. Es können auch geräteunabhängige Profile wie sRGB verwendet werden. Wenn das Farbprofil nicht einem Hardwaregerät zugeordnet ist, wird es von GetICMProfile, aber nicht von EnumICMProfiles zurückgegeben.
Beachten Sie, dass unter Windows 95 oder höher der PostScript-Gerätetreiber für Drucker von einem CMYK-Farbmodell ausgeht. Daher müssen alle PostScript-Drucker ein CMYK-Farbprofil verwenden. Windows 2000 verfügt nicht über diese Einschränkung.
SetICMProfile unterstützt nur RGB-Profile in kompatiblen DCs.
Windows 95/98/Me: SetICMProfileW wird von Microsoft Layer for Unicode unterstützt. Um dies zu verwenden, müssen Sie Ihrer Anwendung bestimmte Dateien hinzufügen, wie unter Microsoft Layer for Unicode unter Windows 95/98/Me Systems beschrieben.
Hinweis
Der wingdi.h-Header definiert SetICMProfile als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | wingdi.h |
Bibliothek | Gdi32.lib |
DLL | Gdi32.dll |