GetEnhMetaFilePaletteEntries 함수(wingdi.h)

GetEnhMetaFilePaletteEntries 함수는 지정된 향상된 메타파일에서 선택적 팔레트 항목을 검색합니다.

구문

UINT GetEnhMetaFilePaletteEntries(
  [in]  HENHMETAFILE   hemf,
  [in]  UINT           nNumEntries,
  [out] LPPALETTEENTRY lpPaletteEntries
);

매개 변수

[in] hemf

향상된 메타파일의 핸들입니다.

[in] nNumEntries

선택적 팔레트에서 검색할 항목 수입니다.

[out] lpPaletteEntries

색상표 색을 수신하는 PALETTEENTRY 구조체 배열에 대한 포인터입니다. 배열에는 cEntries 매개 변수로 지정된 항목이 있는 만큼의 구조체가 포함되어야 합니다.

반환 값

배열 포인터가 NULL 이고 향상된 메타파일이 선택적 팔레트를 포함하는 경우 반환 값은 향상된 메타파일 팔레트의 항목 수입니다. 배열 포인터가 유효한 포인터이고 향상된 메타파일에 선택적 팔레트가 포함되어 있으면 반환 값은 복사된 항목의 수입니다. 메타파일에 선택적 팔레트가 없으면 반환 값은 0입니다. 그렇지 않으면 반환 값이 GDI_ERROR.

설명

애플리케이션은 그림을 만들고 메타파일에 저장하기 전에 CreatePalette 및 SetPaletteEntries 함수를 호출하여 향상된 메타파일에 선택적 팔레트를 저장할 수 있습니다. 이렇게 하면 다양한 디바이스에 그림이 표시될 때 애플리케이션에서 일관된 색을 얻을 수 있습니다.

향상된 메타파일에 저장된 그림을 표시하는 애플리케이션은 GetEnhMetaFilePaletteEntries 함수를 호출하여 선택적 팔레트가 있는지 여부를 확인할 수 있습니다. 이 경우 애플리케이션은 GetEnhMetaFilePaletteEntries 함수를 두 번째로 호출하여 팔레트 항목을 검색한 다음 논리 팔레트를 만들고( CreatePalette 함수를 사용하여) 디바이스 컨텍스트( SelectPalette 함수 사용)로 선택한 다음 , RealizePalette 함수를 사용하여 이를 실현할 수 있습니다. 논리 팔레트가 실현된 후 PlayEnhMetaFile 함수를 호출하면 원래 색을 사용하여 그림이 표시됩니다.

요구 사항

추가 정보

CreatePalette

메타파일 함수

메타파일 개요

PALETTEENTRY

PlayEnhMetaFile

RealizePalette

SelectPalette