IInkStrokeDisp::GetBoundingBox 메서드(msinkaut.h)

  • 아티클

InkDisp 개체의 모든 스트로크, 개별 스트로크 또는 InkStrokes 컬렉션에 대한 잉크 공간 좌표의 경계 상자를 검색합니다.

구문

HRESULT GetBoundingBox(
  [in, optional] InkBoundingBoxMode BoundingBoxMode,
  [out, retval]  IInkRectangle      **Rectangle
);

매개 변수

[in, optional] BoundingBoxMode

선택 사항입니다. 경계 상자를 계산하는 데 사용할 스트로크 특성을 지정합니다. 기본값은 -1로, 스트로크의 모든 특성이 경계 상자를 지정하는 데 사용됨을 나타냅니다.

스트로크 특성을 사용하여 경계 상자를 계산하는 방법에 대한 자세한 내용은 BoundingBoxMode 열거형 형식을 참조하세요.

[out, retval] Rectangle

이 메서드가 반환되면 InkDisp 개체, IInkStrokeDisp 개체 또는 InkStrokes 컬렉션의 경계 상자를 정의하는 사각형에 대한 포인터가 포함됩니다.

참고IInkStrokeDisp 개체의 경우 반환된 경계 상자는 스트로크 경계 상자의 복사본이므로 반환된 경계 상자를 변경해도 스트로크 위치에 영향을 주지 않습니다.
 

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 성공.
E_POINTER
 매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INK_EXCEPTION
 메서드 내에서 예외가 발생했습니다.
E_UNEXPECTED
 예기치 않은 매개 변수 또는 속성 형식입니다.
REGDB_CLASSNOTREG
 InkRectangle 개체가 등록되지 않았습니다.

설명

경계 상자가 펜 너비의 영향을 받는 경우 이 너비는 InkRenderer의 뷰 변환에 맞게 적절하게 조정됩니다. 이렇게 하려면 펜 너비에 뷰 변환 결정자의 제곱근을 곱합니다.

참고 Windows Vista 이상 버전에서 GetBoundingBox 메서드 는 스트로크의 너비를 고려하지 않습니다.
 
참고 펜 너비를 명시적으로 설정하지 않은 경우 기본적으로 53입니다. 올바른 경계 상자를 생성하려면 펜 너비를 결정자의 제곱근에 곱해야 합니다. 경계 상자의 높이와 너비는 각 방향에서 이 크기의 절반만큼 확장됩니다. 예를 들어 펜 너비가 53이고 결정자의 제곱근이 50이고 경계 상자가 (0, 0, 1000, 1000)인 것을 고려합니다. 각 방향의 경계 상자에 대한 펜 너비 조정은 (53 * 50) / 2로 계산되고 오른쪽과 아래쪽 측면은 1씩 증가합니다. 그러면 렌더링된 경계 상자(-1325, -1325, 2326, 2326)가 생성됩니다.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 msinkaut.h
라이브러리 InkObj.dll

추가 정보

IInkStrokeDisp 인터페이스

InkBoundingBoxMode 열거형

InkRectangle 클래스