PatBlt function

PatBlt 함수는 지정된 디바이스 컨텍스트에서 현재 선택된 브러시를 사용하여 지정된 사각형을 그립니다. 브러시 색상과 표면 색상(들)은 지정된 래스터 명령을 사용하여 결합됩니다.

Syntax

  
BOOL PatBlt(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] int   w,
  [in] int   h,
  [in] DWORD rop
);

[in] hdc

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

[in] x

채워질 rectangle의 좌상단 모서리의 x 좌표입니다 (논리적 단위).

[in] y

채워질 rectangle의 좌상단 모서리의 y 좌표입니다 (논리적 단위).

[in] w

사각형의 너비입니다 (논리적 단위).

[in] h

사각형의 높이입니다 (논리적 단위).

[in] rop

래스터 명령 코드입니다. 이 코드는 다음 값 중 하나가 될 수 있습니다.

값	의미
PATCOPY	목적지 비트맵에 지정된 패턴을 복사합니다.
PATINVERT	불린 XOR 연산을 사용하여 지정된 패턴의 색상을 목적지 rectangle의 색상과 결합합니다.
DSTINVERT	목적지 rectangle을 반전합니다.
BLACKNESS	목적지 rectangle을 물리적 팔레트 내 인덱스 0과 연결된 색상을 사용하여 채웁니다 (이 색상은 기본 물리적 팔레트의 경우 검정색입니다).
WHITENESS	목적지 rectangle을 물리적 팔레트 내 인덱스 1과 연결된 색상을 사용하여 채웁니다 (이 색상은 기본 물리적 팔레트의 경우 흰색입니다).

함수가 성공하면, 리턴 값은 0이 아닙니다.

함수가 실패하면, 리턴 값은 0입니다.

이 함수의 dwRop 파라미터의 값은 전체 256개의 삼항 래스터 명령 코드들의 제한된 하위 집합입니다. 특히, source rectangle을 참조하는 명령 코드는 사용할 수 없습니다.

모든 디바이스들이 PatBlt 함수를 지원하지는 않습니다. 더 많은 정보를 보려면, GetDeviceCaps 함수 문서의 RC_BITBLT capability의 설명을 보세요.

예제 코드를 보려면, Using Menus 문서의 “Example of Menu-Item Bitmaps” 항목을 보세요.