GetSystemPaletteEntries 함수(wingdi.h)

아티클
08/27/2023

GetSystemPaletteEntries 함수는 지정된 DC(디바이스 컨텍스트)와 연결된 시스템 팔레트에서 다양한 팔레트 항목을 검색합니다.

구문

UINT GetSystemPaletteEntries(
  [in]  HDC            hdc,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] iStart

시스템 팔레트에서 검색할 첫 번째 항목입니다.

[in] cEntries

시스템 팔레트에서 검색할 항목 수입니다.

[out] pPalEntries

색상표 항목을 받을 PALETTEENTRY 구조체 배열에 대한 포인터입니다. 배열은 cEntries 매개 변수에 지정된 개수 이상의 구조를 포함해야 합니다. 이 매개 변수가 NULL이면 함수는 색상표의 총 항목 수를 반환합니다.

반환 값

함수가 성공하면 반환 값은 팔레트에서 검색된 항목 수입니다.

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

설명

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

요구 사항

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