다음을 통해 공유

InkCollector.SetWindowInputRectangle 메서드

  • 아티클

업데이트: 2007년 11월

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

네임스페이스:  Microsoft.Ink
어셈블리:  Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
Public Sub SetWindowInputRectangle ( _
    windowInputRectangle As Rectangle _
)
‘사용 방법
Dim instance As InkCollector
Dim windowInputRectangle As Rectangle

instance.SetWindowInputRectangle(windowInputRectangle)

public void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public:
void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public function SetWindowInputRectangle(
    windowInputRectangle : Rectangle
)

매개 변수

설명

기본적으로 창 입력 사각형은 {0,0,0,0}으로 설정됩니다. 이 기본 사각형은 전체 창의 크기에 매핑됩니다. 창 입력 사각형을 기본 좌표가 적용된 빈 사각형으로 다시 설정하려면 SetWindowInputRectangle 메서드 호출에 {0,0,0,0}을 전달합니다.

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

사각형을 음수 좌표 공간에 지정할 수도 있지만, 이렇게 하면 잉크로 처리할 수 없는 창이 항상 나타나므로 의미가 없습니다.

경고

  창 입력 사각형이 Splitter 컨트롤 또는 창 테두리에 겹치도록 설정하는 경우에는 창 크기를 조정할 때 예기치 않은 결과가 발생할 수 있습니다.

참고

특정 메시지 처리기 내에서 이 함수를 호출하면 재진입이 발생하여 예기치 않은 결과가 나타납니다. WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT, WM_SYSKEYDOWN(Alt+Tab 또는 Alt+Esc 키 조합을 처리하는 경우) 메시지 중 하나를 처리할 때는 재진입 호출이 발생하지 않도록 주의해야 합니다. wParam이 SC_HOTKEY 또는 SC_TASKLIST로 설정된 경우에는 WM_SYSCOMMAND도 여기에 해당합니다. 이는 단일 스레드 아파트 모델 응용 프로그램에 적용되는 문제입니다.

예제

이 C# 예제에서는 SetWindowInputRectangle 메서드를 호출하여 잉크 입력 영역을 연결된 InkCollector 개체인 theInkCollector의 전체 창 크기로 설정합니다.

using Microsoft.Ink;
//...
InkCollector theInkCollector;
public Form1()
{
    // Initialization
    theInkCollector = new InkCollector(Handle);
    Rectangle theRect = new Rectangle(0,0,0,0);
    theInkCollector.SetWindowInputRectangle(theRect);
    //...
}

이 Visual Basic .NET 예제에서는 SetWindowInputRectangle 메서드를 호출하여 잉크 입력 영역을 연결된 InkCollector 개체인 theInkCollector의 전체 창 크기로 설정합니다.

Imports Microsoft.Ink
Dim theInkCollector As InkCollector
Public Sub Form1()
    'Initialization
    Dim theRect As Rectangle
    theInkCollector = New InkCollector(Handle)
    theRect = New Rectangle(0,0,0,0)
    theInkCollector.SetWindowInputRectangle(theRect)
    '...
End Sub

플랫폼

Windows Vista

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

3.0에서 지원

참고 항목

참조

InkCollector 클래스

InkCollector 멤버

Microsoft.Ink 네임스페이스

InkCollector.GetWindowInputRectangle