SetColorProfileElementSize 函式 (icm.h)
在 ICC 色彩設定檔中設定標記專案的大小。
語法
BOOL SetColorProfileElementSize(
HPROFILE hProfile,
TAGTYPE tagType,
DWORD pcbElement
);
參數
hProfile
指定有問題的 ICC 色彩設定檔句柄。
tagType
識別標記的專案。
pcbElement
指定要將標記項目設定為的大小。 如果 cbSize 為零,此函式會刪除指定的標記專案。 如果標籤是參考,則只會刪除標記數據表專案,而不是數據。
傳回值
如果此函式成功,則傳回值為 TRUE。
如果此函式失敗,則傳回值為 FALSE。 如需擴充的錯誤資訊,請呼叫 GetLastError。
備註
如果 hProfile 不是有效的 ICC 設定檔,此函式將會失敗。
若要在色彩配置檔中建立新的標記專案,請使用 SetColorProfileElementSize 來設定大小,然後使用 SetColorProfileElement 來設定元素值。
如果指定的標籤已存在於配置檔中, SetColorProfileElementSize 會藉由截斷元素的大小,或在結尾加上零,因為案例可能如此。
如果指定的標籤已經存在,而且是另一個標記的參考, SetColorProfileElementSize 會為未共用的標籤建立新的數據區域。
此函式不支援 Windows Color System (WCS) 配置檔 CAMP、DMP 和 GMMP;因為配置檔元素會隱含地與和硬式編碼為 ICC 標籤類型相關聯,而且有許多健全的 XML 剖析連結庫。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
標頭 | icm.h |
程式庫 | Mscms.lib |
Dll | Mscms.dll |