SetDIBColorTable 함수(wingdi.h)

SetDIBColorTable 함수는 현재 지정된 디바이스 컨텍스트로 선택된 DIB의 색 테이블에 있는 항목 범위에서 RGB(빨강, 녹색, 파랑) 색 값을 설정합니다.

구문

UINT SetDIBColorTable(
  [in] HDC           hdc,
  [in] UINT          iStart,
  [in] UINT          cEntries,
  [in] const RGBQUAD *prgbq
);

[in] hdc

디바이스 컨텍스트입니다. 이 디바이스 컨텍스트에서 DIB를 선택해야 합니다.

[in] iStart

설정할 첫 번째 색상표 항목을 지정하는 색상표 인덱스(0부터 시작)입니다.

[in] cEntries

설정할 색상표 항목 수입니다.

[in] prgbq

DIB의 색 테이블에 대한 새 색 정보를 포함하는 RGBQUAD 구조체 배열에 대한 포인터입니다.

함수가 성공하면 반환 값은 함수가 설정하는 색 테이블 항목의 수입니다.

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

1, 4 또는 8 bpp를 사용하는 DIB에 대한 색 테이블을 설정하려면 이 함수를 호출해야 합니다. 비트맵의 연결된 비트맵 정보 헤더 구조체의 BitCount 멤버입니다.

BITMAPINFOHEADER 구조체는 픽셀당 비트 수를 지정합니다. biBitCount 값이 8보다 큰 디바이스 독립적 비트맵에는 색 테이블이 없습니다.

비트맵의 연결된 BITMAPV5HEADER 구조체의 bV5BitCount 멤버는 픽셀당 비트 수를 지정합니다. bV5BitCount 값이 8보다 큰 디바이스 독립적 비트맵에는 색 테이블이 없습니다.

Icm: 색 관리가 수행되지 않습니다.

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