InkCollector 클래스

아티클
11/04/2008

업데이트: 2007년 11월

사용 가능한 태블릿 장치에서 잉크를 캡처하는 데 사용되는 개체를 나타냅니다.

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

구문

‘선언
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class InkCollector _
    Implements IDisposable
‘사용 방법
Dim instance As InkCollector

[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class InkCollector : IDisposable

[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class InkCollector : IDisposable

/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class InkCollector implements IDisposable

public class InkCollector implements IDisposable

설명

경고

메모리 누수가 발생하지 않도록 하려면 개체가 범위를 벗어나기 전에 이벤트 처리기가 연결되어 있는 모든 InkCollector 개체의 Dispose 메서드를 명시적으로 호출해야 합니다.

InkCollector 개체는 잉크 및 제스처 입력만을 수집합니다. InkCollector는 Cursor 및 Tablet 등의 개체를 사용하여 하드웨어에서 잉크를 수집해 응용 프로그램으로 전달하는 용도로만 사용됩니다. 즉, 잉크의 하나 또는 여러 개의 Ink 개체로 분산시킵니다. 이 개체는 분산된 잉크를 보관하는 컨테이너 역할을 합니다.

InkCollector를 사용하려면 해당 개체를 만들고, 그려진 잉크를 수집할 창을 설정한 다음 활성화하면 됩니다. InkCollector를 활성화하면 CollectionMode 열거형에서 지정하는 세 가지 모드 중 하나에서만 잉크를 수집할 수 있습니다.

InkOnly: Stroke 개체가 만들어집니다.
GestureOnly: Gesture 개체가 만들어집니다.
InkAndGesture: 응용 프로그램의 이벤트 처리 방식에 따라 스트로크나 제스처 또는 두 가지가 모두 만들어집니다.

태블릿 범위 내의 모든 커서 이동에 대해 InkCollector는 스트로크나 제스처 또는 두 가지를 모두 수집합니다. 제스처는 Microsoft 제스처 인식기를 통해 기본적으로 지원됩니다.

InkCollector는 태블릿 입력을 처리합니다. 마우스를 포함하여 연결된 모든 태블릿에서 잉크를 동시에 수집할 수 있습니다. Cursor 및 CursorButton 개체를 변경하면 InkCollector 개체에서 이벤트를 발생시킬 수 있습니다.

InkCollector도 자신의 수명 동안 발견된 커서 목록을 관리합니다. InkCollector에서 새 커서가 발견되면 CursorInRange 이벤트가 발생하고 InkCollectorCursorInRangeEventArgs 개체의 NewCursor 속성이 true로 설정됩니다. 응용 프로그램에서는 InkCollector를 사용하여 새 커서를 관리합니다.

특정 창 핸들에 여러 InkCollector를 연결할 수 있으며, 이들 항목의 수집 영역(생성자 또는 SetWindowInputRectangle 메서드를 사용하여 설정)이 겹쳐도 됩니다. 그러나 이 시나리오는 InkCollector가 SetSingleTabletIntegratedMode를 호출하며 고유한 태블릿을 사용하는 경우에만 사용 가능합니다. 이러한 동작을 통해 잉크를 각 태블릿에서 별도의 개체에 저장할 수 있습니다.

활성화된 특정 InkCollector 개체의 창 입력 사각형(Enabled 속성으로 설정)이 활성화된 다른 InkCollector의 창 입력 사각형과 겹치면 오류가 발생합니다.

참고

입력 사각형이 서로 겹쳐도 이러한 사각형 중 하나만 활성화되어 있으면 오류가 발생하지 않습니다.

MouseDown, MouseMove, MouseUp 및 MouseWheel 이벤트는 잉크 공간과 연결된 HIMETRIC 단위가 아닌 픽셀 단위로 X 및 Y 좌표를 반환합니다. 이들 이벤트는 펜을 인식하지 않는 응용 프로그램의 마우스 이벤트를 대체하며, 이러한 응용 프로그램에서는 픽셀 단위만을 인식하기 때문입니다.

InkCollector의 동작은 Microsoft Visual Basic을 사용하여 만든 응용 프로그램과 MFC(Microsoft Foundation Class)를 사용하여 만든 응용 프로그램에서 각각 다릅니다. 이러한 동작에 대한 자세한 내용은 Ink Collection을 참조하십시오.

참고

InkCollector 개체를 비 UI(사용자 인터페이스) 스레드에서 해제하는 것은 안전하지 않을 수 있습니다.

응용 프로그램의 성능을 높이려면 더 이상 사용되지 않는 InkCollector 개체를 수동으로 삭제합니다.

보안 정보:
부분 신뢰 환경에서 사용하는 경우 이 클래스와 모든 해당 메서드에 UIPermissionWindow.SafeTopLevelWindows 권한이 필요합니다. 자세한 내용은 Security And Trust를 참조하십시오.