GetEnhMetaFilePaletteEntries 函式 (wingdi.h)
GetEnhMetaFilePaletteEntries函式會從指定的增強中繼檔擷取選擇性調色盤專案。
語法
UINT GetEnhMetaFilePaletteEntries(
[in] HENHMETAFILE hemf,
[in] UINT nNumEntries,
[out] LPPALETTEENTRY lpPaletteEntries
);
參數
[in] hemf
增強型中繼檔控制碼。
[in] nNumEntries
要從選擇性調色盤擷取的專案數目。
[out] lpPaletteEntries
接收調色盤色彩之 PALETTEENTRY 結構的陣列指標。 陣列必須至少包含 cEntries 參數所指定的專案數目。
傳回值
如果陣列指標為 Null ,且增強的中繼檔包含選擇性調色盤,則傳回值是增強中繼檔調色盤中的專案數;如果陣列指標是有效的指標,且增強型中繼檔包含選擇性調色盤,則傳回值是複製的專案數;如果中繼檔不包含選擇性調色盤,則傳回值為零。 否則,傳回值會GDI_ERROR。
備註
應用程式可以呼叫CreatePalette 和 SetPaletteEntries函式,再建立圖片並將它儲存在中繼檔中,以將選擇性調色盤儲存在增強中繼檔中。 如此一來,當圖片顯示在各種裝置上時,應用程式就可以達到一致的色彩。
顯示儲存在增強中繼檔中的圖片的應用程式可以呼叫 GetEnhMetaFilePaletteEntries 函式,以判斷選擇性調色盤是否存在。 如果這樣做,應用程式可以再次呼叫 GetEnhMetaFilePaletteEntries 函式來擷取調色盤專案,然後使用 CreatePalette 函式) 建立邏輯調色盤 (,然後使用 SelectPalette 函式) 將其選取到其裝置內容 (,然後使用 RealizePalette 函式) 來將其 (。 在邏輯調色盤實現之後,呼叫 PlayEnhMetaFile 函式會使用其原始色彩來顯示圖片。
規格需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wingdi.h (包含 Windows.h) |
程式庫 | Gdi32.lib |
Dll | Gdi32.dll |