GetPaletteEntries 함수(wingdi.h)

아티클
08/27/2023

GetPaletteEntries 함수는 지정된 논리 팔레트에서 지정된 색상표 항목 범위를 검색합니다.

구문

UINT GetPaletteEntries(
  [in]  HPALETTE       hpal,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

매개 변수

[in] hpal

논리 팔레트에 대한 핸들입니다.

[in] iStart

검색할 논리 팔레트의 첫 번째 항목입니다.

[in] cEntries

검색할 논리 팔레트의 항목 수입니다.

[out] pPalEntries

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

반환 값

함수가 성공하고 논리 팔레트에 대한 핸들이 유효한 포인터( NULL이 아님)인 경우 반환 값은 논리 팔레트에서 검색된 항목의 수입니다. 함수가 성공하고 논리 팔레트에 대한 핸들이 NULL이면 반환 값은 지정된 색상표의 항목 수입니다.

함수가 실패하면 반환 값은 0입니다.

설명

애플리케이션은 GetDeviceCaps 함수를 호출하고 RASTERCAPS 상수를 지정하여 디바이스가 팔레트 작업을 지원하는지 여부를 확인할 수 있습니다.

nEntries 매개 변수가 색상표에 있는 것보다 더 많은 항목을 지정하는 경우 PALETTEENTRY 구조체의 나머지 멤버는 변경되지 않습니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll