SetBoundsRect 함수(wingdi.h)

SetBoundsRect 함수는 지정된 디바이스 컨텍스트에 대한 경계 사각형 정보의 누적을 제어합니다. 시스템은 모든 그리기 작업에 대한 경계 사각형을 유지할 수 있습니다. 애플리케이션은 이 사각형을 검사하고 설정할 수 있습니다. 그리기 경계는 비트맵 캐시를 무효화하는 데 유용합니다.

구문

UINT SetBoundsRect(
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

매개 변수

[in] hdc

경계 사각형을 누적할 디바이스 컨텍스트에 대한 핸들입니다.

[in] lprect

경계 사각형을 설정하는 데 사용되는 RECT 구조체에 대한 포인터입니다. 사각형 차원은 논리적 좌표에 있습니다. 이 매개 변수는 NULL일 수 있습니다.

[in] flags

새 사각형을 누적된 사각형과 결합하는 방법을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
DCB_ACCUMULATE	lprcBounds 매개 변수로 지정된 사각형을 경계 사각형에 추가합니다(사각형 공용 구조체 작업 사용). DCB_RESET 및 DCB_ACCUMULATE 모두 사용하면 경계 사각형이 lprcBounds 매개 변수로 지정된 사각형으로 설정됩니다.
DCB_DISABLE	경계 누적을 해제합니다.
DCB_ENABLE	기본적으로 사용하지 않도록 설정된 경계 누적을 켭니다.
DCB_RESET	경계 사각형을 지웁니다.

반환 값

함수가 성공하면 반환 값은 경계 사각형의 이전 상태를 지정합니다. 이 상태는 다음 값의 조합일 수 있습니다.

값	의미
DCB_DISABLE	경계 누적이 해제되었습니다.
DCB_ENABLE	경계 누적이 켜집니다. DCB_ENABLE 및 DCB_DISABLE 상호 배타적입니다.
DCB_RESET	경계 사각형이 비어 있습니다.
DCB_SET	경계 사각형이 비어 있지 않습니다. DCB_SET 및 DCB_RESET 상호 배타적입니다.

 

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

설명

DCB_SET 값은 DCB_ACCUMULATE 및 DCB_RESET 비트 값의 조합입니다. 경계 사각형이 비어 있는지 여부를 확인하기 위해 DCB_RESET 비트를 검사 애플리케이션도 DCB_ACCUMULATE 비트를 검사 합니다. 경계 사각형은 DCB_RESET 비트가 1이고 DCB_ACCUMULATE 비트가 0인 경우에만 비어 있습니다.

요구 사항

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

추가 정보

GetBoundsRect

그리기 및 그리기 함수

그리기 및 그리기 개요

RECT