잉크가 그려지는 창 사각형을 픽셀 단위로 설정합니다.
문법
HRESULT SetWindowInputRectangle(
[in] IInkRectangle *WindowInputRectangle
);
매개 변수
[in] WindowInputRectangle
잉크가 그려지는 창 좌표의 사각형입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
성공. |
|
매개 변수에 잘못된 포인터가 포함되어 있습니다. |
|
사각형 좌표가 잘못되었습니다(예: 너비/높이 0). |
|
스트로크 중간에 있는 동안에는 매핑을 업데이트할 수 없습니다. |
|
메서드 내에서 예외가 발생했습니다. |
|
창 입력 사각형은 사용 가능한 InkCollector의 창 입력 사각형과 겹칩니다. |
비고
사용 가능한 잉크 수집기( Enabled 속성으로 설정)의 창 입력 사각형이 사용 가능한 다른 잉크 수집기의 창 입력 사각형과 겹치면 E_INK_OVERLAPPING_INPUT_RECT 오류가 반환됩니다.
참고 입력 사각형 중 하나만 알려진 시간에 사용하도록 설정되면 오류 없이 겹침이 발생할 수 있습니다.
창 입력 사각형을 기본 동작(좌표{0,0,0,0}가 있는 빈 사각형)으로 다시 설정하려면 NULL이 아닌 SetWindowInputRectangle에 대한 호출을 전달 {0,0,0,0} 합니다.
오른쪽 속성의 값이 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 Tablet PC Edition [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| Header | msinkaut.h |