Bitmap::InitializePalette 메서드(gdiplusheaders.h)

Bitmap::InitializePalette 메서드는 표준, 최적 또는 사용자 지정 색상표를 초기화합니다.

구문

Status InitializePalette(
  [in, out] ColorPalette *palette,
  [in]      PaletteType  palettetype,
  [in]      INT          optimalColors,
  [in]      BOOL         useTransparentColor,
  [in]      Bitmap       *bitmap
);

매개 변수

[in, out] palette

형식: ColorPalette*

ColorPalette 구조체와 ARGB 값 배열이 포함된 버퍼에 대한 포인터입니다. ColorPalette 구조체의 Flags 및 Count 멤버를 설정해야 합니다. ColorPalette 구조체의 Entries 멤버는 하나의 ARGB 값 배열입니다. ColorPalette 구조체 및 색상표의 추가 ARGB 값에 메모리를 할당해야 합니다. 예를 들어 팔레트에 36개의 ARGB 값이 있는 경우 다음과 같이 버퍼를 할당합니다. malloc(sizeof(ColorPalette) + 35*sizeof(ARGB))

[in] palettetype

형식: PaletteType

색상표 유형을 지정하는 PaletteType 열거형의 요소입니다. 색상표에는 여러 표준 형식 중 하나가 있거나 정의한 사용자 지정 색상표일 수 있습니다. 또한 Bitmap::InitializePalette 메서드는 지정된 비트맵을 기반으로 최적의 팔레트를 만들 수 있습니다.

[in] optimalColors

형식: INT

지정된 비트맵을 기반으로 최적의 색상표에 사용할 색 수를 지정하는 정수입니다. 이 매개 변수가 0보다 크면 palettetype 매개 변수를 PaletteTypeOptimal로 설정해야 하며 비트맵 매개 변수는 Bitmap 개체를 가리 킵니다. 최적의 색상표가 아닌 표준 또는 사용자 지정 팔레트를 만드는 경우 이 매개 변수를 0으로 설정합니다.

[in] useTransparentColor

형식: BOOL

색상표에 투명한 색을 포함할지 여부를 지정하는 부울 값입니다. 투명한 색을 포함하려면 TRUE 로 설정합니다. 그렇지 않으면 FALSE입니다.

[in] bitmap

형식: 비트맵*

최적의 색상표를 만들 Bitmap 개체에 대한 포인터입니다. palettetype이 PaletteTypeOptimal로 설정되고 optimalColors가 양의 정수로 설정된 경우 이 매개 변수를 Bitmap 개체의 주소로 설정합니다. 그렇지 않으면 이 매개 변수를 NULL로 설정합니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 확인을 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

요구 사항

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

추가 정보

Bitmap