SetBrushOrgEx 함수(wingdi.h)

아티클
08/27/2023

SetBrushOrgEx 함수는 GDI가 애플리케이션이 선택한 다음 브러시에 할당하는 브러시 원본을 지정된 디바이스 컨텍스트로 설정합니다.

구문

BOOL SetBrushOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

매개 변수

[in] hdc

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

[in] x

새 브러시 원점의 x 좌표(디바이스 단위)입니다. 이 값이 브러시 너비보다 크면 모듈러스 연산자(nXOrgmod 브러시 너비)를 사용하여 해당 값이 줄어듭니다.

[in] y

새 브러시 원점의 y 좌표(디바이스 단위)입니다. 이 값이 브러시 높이보다 크면 모듈러스 연산자(nYOrg모드 브러시 높이)를 사용하여 해당 값이 줄어듭니다.

[out] lppt

이전 브러시 원점을 수신하는 POINT 구조체에 대한 포인터입니다.

이전 브러시 원본이 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

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

설명

브러시는 시스템이 채워진 셰이프의 내부를 그리는 데 사용하는 비트맵입니다.

브러시 원점은 비트맵에서 1픽셀의 위치를 지정하는 좌표 쌍입니다. 기본 브러시 원점 좌표는 (0,0)입니다. 가로 좌표의 경우 값 0은 픽셀의 맨 왼쪽 열에 해당합니다. 너비는 가장 오른쪽 열에 해당합니다. 세로 좌표의 경우 값 0은 픽셀의 맨 위 행에 해당합니다. 높이가 가장 낮은 행에 해당합니다.

시스템은 모든 창 관리 디바이스 컨텍스트의 원본을 자동으로 추적하고 필요에 따라 브러시를 조정하여 표면의 패턴 맞춤을 유지합니다. 이 호출로 설정된 브러시 원점은 클라이언트 영역의 왼쪽 위 모서리를 기준으로 합니다.

애플리케이션은 SetStretchBltMode를 사용하여 비트맵 스트레치 모드를 HALFTONE로 설정한 후 SetBrushOrgEx를 호출해야 합니다. 브러시가 잘못 정렬되지 않도록 하려면 이 작업을 수행해야 합니다.

시스템은 모든 창 관리 디바이스 컨텍스트의 원본을 자동으로 추적하고 필요에 따라 브러시를 조정하여 표면의 패턴 맞춤을 유지합니다.

요구 사항


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