IInkCollector::SetWindowInputRectangle 메서드(msinkaut.h)

  • 아티클

잉크가 그려지는 창 사각형을 픽셀 단위로 설정합니다.

구문

HRESULT SetWindowInputRectangle(
  [in] IInkRectangle *WindowInputRectangle
);

매개 변수

[in] WindowInputRectangle

잉크가 그려지는 창 좌표의 사각형입니다.

반환 값

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

반환 코드 설명
S_OK
 성공.
E_POINTER
 매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INVALIDARG
 사각형 좌표가 잘못되었습니다(예: 너비/높이 0).
E_INK_COLLECTOR_BUSY
 스트로크 중간에 있는 동안에는 매핑을 업데이트할 수 없습니다.
E_INK_EXCEPTION
 메서드 내에서 예외가 발생했습니다.
E_INK_OVERLAPPING_INPUT_RECT
 창 입력 사각형은 사용 가능한 InkCollector의 창 입력 사각형과 겹칩니다.

설명

사용 가능한 잉크 수집기의 창 입력 사각형( Enabled 속성으로 설정)이 다른 사용 가능한 잉크 수집기의 창 입력 사각형과 겹치면 E_INK_OVERLAPPING_INPUT_RECT 오류가 반환됩니다.

참고 입력 사각형 중 하나만 알려진 시간에 사용하도록 설정된 경우 오류 없이 겹침이 발생할 수 있습니다.
 
기본적으로 창 입력 사각형은 로 {0,0,0,0}설정됩니다. 이 기본 사각형은 전체 창의 크기에 매핑됩니다.

창 입력 사각형을 기본 동작(좌표{0,0,0,0}가 있는 빈 사각형)으로 다시 설정하려면 NULL이 아닌 SetWindowInputRectangle에 호출을 전달 {0,0,0,0} 합니다.

Right 속성 값이 Left 속성 값보다 작은 사각형은 전달할 수 없습니다. 또는 Bottom 속성의 값이 Top 속성 값보다 작은 경우 예를 들어 매개 변수가 {500, 500, 400, 400}인 사각형은 유효하지 않습니다.

주의 창 입력 사각형을 분할기 컨트롤 또는 창의 테두리와 겹치도록 설정하면 창 크기가 조정될 때 예측할 수 없는 결과가 발생할 수 있습니다.
 
참고 특정 메시지 처리기 내에서 이 메서드를 호출하면 기본 함수가 다시 입력되어 예기치 않은 결과가 발생할 수 있습니다. WM_ACTIVATE,WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT 메시지를 처리할 때 재진입 호출을 방지합니다. wParam이 SC_HOTKEY 또는 SC_TASKLIST 설정된 경우 WM_SYSCOMMAND. 및 WM_SYSKEYDOWN(Alt+TAB 또는 Alt+ESC 키 조합을 처리하는 경우). 이것은 단일 스레드 아파트 모델 애플리케이션의 문제입니다.
 

요구 사항

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

참고 항목

Enabled 속성

GetWindowInputRectangle 메서드

IInkCollector

InkCollector 클래스