CreateDIBPatternBrush 함수(wingdi.h)

아티클
08/27/2023

CreateDIBPatternBrush 함수는 지정된 DIB(디바이스 독립적 비트맵)로 지정된 패턴이 있는 논리 브러시를 만듭니다. 이후에 래스터 작업을 지원하는 디바이스와 연결된 모든 디바이스 컨텍스트에서 브러시를 선택할 수 있습니다.

참고 이 함수는 16비트 버전의 Windows와의 호환성을 위해서만 제공됩니다. 애플리케이션은 CreateDIBPatternBrushPt 함수를 사용해야 합니다.

구문

HBRUSH CreateDIBPatternBrush(
  [in] HGLOBAL h,
  [in] UINT    iUsage
);

매개 변수

[in] h

압축된 DIB를 포함하는 전역 메모리 개체에 대한 핸들입니다. 이 핸들은 BITMAPINFO 구조체와 비트맵의 픽셀을 정의하는 바이트 배열로 즉시 구성됩니다.

[in] iUsage

BITMAPINFO 구조체의 bmiColors 멤버가 초기화되는지 여부와 이 멤버에 명시적 빨강, 녹색, 파랑(RGB) 값 또는 인덱스가 논리적 팔레트에 포함되어 있는지 여부를 지정합니다. fuColorSpec 매개 변수는 다음 값 중 하나여야 합니다.

값	의미
DIB_PAL_COLORS	색 테이블이 제공되며 브러시를 선택할 디바이스 컨텍스트의 논리적 팔레트에 16비트 인덱스 배열로 구성됩니다.
DIB_RGB_COLORS	색 테이블이 제공되며 리터럴 RGB 값이 포함됩니다.

반환 값

함수가 성공하면 반환 값은 논리 브러시를 식별합니다.

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

설명

애플리케이션이 단색 디바이스 컨텍스트로 2색 DIB 패턴 브러시를 선택하면 시스템은 DIB에 지정된 색을 인정하지 않습니다. 대신 디바이스 컨텍스트의 현재 배경 및 전경색을 사용하여 패턴 브러시를 표시합니다. DIB의 첫 번째 색에 매핑된 픽셀(DIB 색 표의 오프셋 0)은 전경색을 사용하여 표시됩니다. 두 번째 색에 매핑된 픽셀(색 표의 오프셋 1)은 배경색을 사용하여 표시됩니다.

브러시가 더 이상 필요하지 않으면 DeleteObject 함수를 호출하여 삭제합니다.

Icm: 브러시를 만들 때는 색이 수행되지 않습니다. 그러나 브러시를 ICM 지원 디바이스 컨텍스트로 선택하면 색 관리가 수행됩니다.

요구 사항

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