Freigeben über

SetColorProfileElementSize-Funktion (icm.h)

  • Artikel

Legt die Größe eines markierten Elements in einem ICC-Farbprofil fest.

Syntax

BOOL SetColorProfileElementSize(
  HPROFILE hProfile,
  TAGTYPE  tagType,
  DWORD    pcbElement
);

Parameter

hProfile

Gibt ein Handle für das betreffende ICC-Farbprofil an.

tagType

Identifiziert das markierte Element.

pcbElement

Gibt die Größe an, auf die das markierte Element festgelegt werden soll. Wenn cbSize null ist, löscht diese Funktion das angegebene markierte Element. Wenn das Tag ein Verweis ist, werden nur der Tagtabelleneintrag gelöscht, nicht die Daten.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Diese Funktion schlägt fehl, wenn hProfile kein gültiges ICC-Profil ist.

Um ein neues markiertes Element in einem Farbprofil zu erstellen, verwenden Sie SetColorProfileElementSize , um die Größe festzulegen. Verwenden Sie dann SetColorProfileElement , um den Elementwert festzulegen.

Wenn das angegebene Tag bereits im Profil vorhanden ist, ändert SetColorProfileElementSize die Größe des Elements, indem es es abschneidet oder am Ende ggf. Nullen hinzufügt.

Wenn das angegebene Tag bereits vorhanden ist und ein Verweis auf ein anderes Tag ist, erstellt SetColorProfileElementSize einen neuen Datenbereich für das Tag, das nicht freigegeben wird.

Diese Funktion unterstützt keine WCS-Profile (Windows Color System) CAMP, DMP und GMMP. da Profilelemente implizit mit ICC-Tagtypen verknüpft und hart codiert sind und viele robuste XML-Analysebibliotheken vorhanden sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile icm.h
Bibliothek Mscms.lib
DLL Mscms.dll

Weitere Informationen