다음을 통해 공유


GetNearestPaletteIndex 함수(wingdi.h)

GetNearestPaletteIndex 함수는 지정된 색 값과 가장 일치하는 지정된 논리 팔레트의 항목에 대한 인덱스를 검색합니다.

구문

UINT GetNearestPaletteIndex(
  [in] HPALETTE h,
  [in] COLORREF color
);

매개 변수

[in] h

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

[in] color

일치시킬 색입니다. COLORREF 색 값을 만들려면 RGB 매크로를 사용합니다.

반환 값

함수가 성공하면 반환 값은 논리적 팔레트에 있는 항목의 인덱스입니다.

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

설명

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

지정된 논리 팔레트에 PC_EXPLICIT 플래그가 설정된 항목이 포함된 경우 반환 값은 정의되지 않습니다.

요구 사항

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

추가 정보

COLORREF

색 함수

색 개요

GetDeviceCaps

GetNearestColor

GetPaletteEntries

GetSystemPaletteEntries

RGB