共用方式為


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

另請參閱

CreatePalette

中繼檔函式

中繼檔概觀

PALETTEENTRY

PlayEnhMetaFile

RealizePalette

SelectPalette