Freigeben über

SetICMProfileW-Funktion (wingdi.h)

  • Artikel

Die SetICMProfile--Funktion legt ein angegebenes Farbprofil als Ausgabeprofil für einen angegebenen Gerätekontext (DC) fest.

Syntax

BOOL SetICMProfileW(
  HDC    hdc,
  LPWSTR 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.

Bemerkungen

SetICMProfile- einem Gerätekontext ein Farbprofil zuordnet. Es wird zum Ausgabeprofil für diesen Gerätekontext. Das Farbprofil muss keinem bestimmten Gerät zugeordnet werden. Geräteunabhängige Profile wie sRGB können ebenfalls verwendet werden. Wenn das Farbprofil keinem Hardwaregerät zugeordnet ist, wird es von GetICMProfilezurückgegeben, aber nicht von EnumICMProfiles.

Beachten Sie, dass unter Windows 95 oder höher der PostScript-Gerätetreiber für Drucker ein CMYK-Farbmodell vorausnimmt. Daher müssen alle PostScript-Drucker ein CMYK-Farbprofil verwenden. Windows 2000 hat diese Einschränkung nicht.

SetICMProfile- unterstützt nur RGB-Profile in kompatiblen DCs.

Windows 95/98/Me: SetICMProfileW- wird von Microsoft Layer für Unicode unterstützt. Um dies zu verwenden, müssen Sie Ihrer Anwendung bestimmte Dateien hinzufügen, wie in Microsoft Layer for Unicode unter Windows 95/98/Me Systemsbeschrieben.

Anmerkung

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
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- wingdi.h
Library Gdi32.lib
DLL- Gdi32.dll

Siehe auch