SelectPalette 함수(wingdi.h)

아티클
03/13/2024

SelectPalette 함수는 지정된 논리 팔레트를 디바이스 컨텍스트로 선택합니다.

구문

HPALETTE SelectPalette(
  [in] HDC      hdc,
  [in] HPALETTE hPal,
  [in] BOOL     bForceBkgd
);

매개 변수

[in] hdc

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

[in] hPal

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

[in] bForceBkgd

논리 팔레트를 백그라운드 팔레트로 강제 적용할지 여부를 지정합니다. 이 값이 TRUE이면 RealizePalette 함수를 사용하면 논리 팔레트가 가능한 최상의 방법으로 실제 색상표에 이미 있는 색에 매핑됩니다. 팔레트가 실현되는 창이 활성 포커스가 없는 스레드에 속하는 경우에도 이 작업은 항상 수행됩니다.

이 값이 FALSE이면 RealizePalette 는 애플리케이션이 포그라운드에 있을 때 논리 팔레트를 디바이스 팔레트에 복사합니다. (hdc 매개 변수가 메모리 디바이스 컨텍스트인 경우 이 매개 변수는 무시됩니다.)

반환 값

함수가 성공하면 반환 값은 디바이스 컨텍스트의 이전 논리 팔레트에 대한 핸들입니다.

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

설명

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

애플리케이션은 디바이스 컨텍스트가 호환되는 경우에만 둘 이상의 디바이스 컨텍스트로 논리 팔레트를 선택할 수 있습니다. 그렇지 않으면 SelectPalette 가 실패합니다. 다른 디바이스 컨텍스트와 호환되는 디바이스 컨텍스트를 만들려면 첫 번째 디바이스 컨텍스트를 매개 변수로 사용하여 CreateCompatibleDC 를 호출합니다. 논리 팔레트를 둘 이상의 디바이스 컨텍스트로 선택한 경우 논리 팔레트를 변경하면 선택한 모든 디바이스 컨텍스트에 영향을 줍니다.

최상위 창의 자식 창이 각각 고유한 팔레트를 실현하는 경우 애플리케이션은 bForceBackground 매개 변수가 TRUE로 설정된 SelectPalette 함수를 호출할 수 있습니다. 그러나 색상표를 실현해야 하는 자식 창만 bForceBackground 를 TRUE로 설정해야 합니다. 다른 자식 창은 이 값을 FALSE로 설정해야 합니다.

요구 사항

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