Freigeben über

SetICMProfileA-Funktion (wingdi.h)

  • Artikel

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

Weitere Informationen