InkEdit 클래스

아티클
11/04/2008

업데이트: 2007년 11월

InkEdit 컨트롤을 사용하면 잉크를 수집 및 인식하고 텍스트로 표시할 수 있습니다. 또한 이 컨트롤은 스마트 폼을 사용하여 텍스트 입력의 정확도를 높일 수 있게 해 줍니다.

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

구문

‘선언
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class InkEdit _
    Inherits RichTextBox
‘사용 방법
Dim instance As InkEdit

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class InkEdit : RichTextBox

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class InkEdit : public RichTextBox

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class InkEdit extends RichTextBox

public class InkEdit extends RichTextBox

설명

이 컨트롤은 RichTextBox 컨트롤의 상위 집합으로, 잉크를 캡처, 인식 및 표시할 수 있는 기능을 사용하여 RichTextBox 컨트롤을 확장합니다.

RichTextBox 컨트롤의 열거형, 이벤트, 메서드 또는 속성이 아래에 문서화되어 있지 않은 경우 InkEdit 컨트롤에서 재정의되지 않으며 RichTextBox 컨트롤 설명서에 설명된 대로 사용할 수 있습니다. 특히 RichNoOleObjs 열거형 필드 같이 RichTextBox 컨트롤과 함께 사용할 경우에만 유효한 것으로 설명된 값과 매개 변수는 InkEdit 컨트롤과 동일하게 작동하는데, 이는 이 컨트롤이 RichTextBox 컨트롤이기 때문입니다.

경고

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

Windows Vista와 함께 InkEdit 컨트롤을 사용할 수 있습니다. InkEdit 컨트롤을 사용하여 Microsoft Windows 2000 및 Windows Server 2003과 Windows XP Tablet PC Edition 이외의 모든 Windows XP 버전에서 잉크를 렌더링할 수는 없습니다. 잉크 입력, 제스처 인식 또는 필기 인식은 다음과 같은 조건하에서만 가능합니다.

잉크는 Windows XP Tablet PC Edition이 설치되어 있는 경우에만 입력 및 인식할 수 있습니다.
제스처는 Windows XP Tablet PC Edition이 설치되어 있는 경우에만 인식할 수 있습니다.
필기는 필기가 다른 위치에서 발생했고 인식기가 있는 경우 텍스트로 인식할 수 있습니다.

Windows 2000 및 Windows Server 2003과 Tablet PC Edition 이외의 Windows XP 버전을 사용하는 경우 InkEdit 컨트롤의 앰비언트 속성에 값을 할당하고 잉크를 다른 응용 프로그램에 복사하여 붙여넣을 수 있지만 해당 InkMode 속성 값은 Disabled입니다.

지능형 공간 삽입은 Windows XP Tablet PC Edition이 설치되어 있는 경우에만 사용할 수 있습니다.

Ink 개체가 포함된 파일은 Windows XP의 모든 버전(Windows XP Tablet PC Edition 포함)과 Tablet PC SDK만 설치할 수 있는 시스템에서 로드하고 표시할 수 있습니다. 그러나 포함된 Ink 개체는 Windows XP Tablet PC Edition이 설치되어 있는 경우에만 텍스트로 변환할 수 있습니다.

잉크 컨트롤에 대한 자세한 내용은 Ink Controls을를 참조하십시오.

특정 이벤트를 발생시키는 스레드에 대한 자세한 내용은 Threads on Which an Event Can Fire을를 참조하십시오.

응용 프로그램의 성능을 높이려면 더 이상 사용되지 않는 InkEdit 컨트롤을 수동으로 삭제합니다.

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

InkEdit 컨트롤의 관리되는 버전은 COM InkEdit 컨트롤을 래핑합니다. COM InkEdit가 오류를 반환하는 경우 관리되는 InkEdit 컨트롤의 생성자, Divide 메서드, LineHeight 속성, RecognizerContext 속성 및 Strokes 속성은 모두 Marshal.ThrowExceptionForHR 예외를 throw합니다. 반환할 수 있는 오류에 대한 자세한 내용은 InkEdit Control Reference 항목을 참조하십시오.