IInkPicture::SetWindowInputRectangle 메서드(msinkaut.h)
잉크가 그려지는 창 사각형을 픽셀 단위로 수정합니다.
구문
HRESULT SetWindowInputRectangle(
[in] IInkRectangle *WindowInputRectangle
);
매개 변수
[in] WindowInputRectangle
잉크가 그려지는 창 좌표의 사각형입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
성공. |
|
매개 변수에 잘못된 포인터가 포함되어 있습니다. |
|
사각형 좌표가 잘못되었습니다(예: 너비/높이 0). |
|
스트로크 중간에 있는 동안에는 매핑을 업데이트할 수 없습니다. |
|
메서드 내에서 예외가 발생했습니다. |
|
창 입력 사각형은 사용 가능한 InkCollector의 창 입력 사각형과 겹칩니다. |
설명
사용 가능한 잉크 수집기( Enabled 속성으로 설정)의 창 입력 사각형이 사용 가능한 다른 잉크 수집기의 창 입력 사각형과 겹치면 E_INK_OVERLAPPING_INPUT_RECT 오류가 반환됩니다.
참고 입력 사각형 중 하나만 알려진 시간에 사용하도록 설정된 경우 오류 없이 겹침이 발생할 수 있습니다.
창 입력 사각형을 기본 동작(좌표{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 |