InkOverlay.Enabled 속성
업데이트: 2007년 11월
InkOverlay 개체가 펜 입력을 수집하는지 여부를 지정하는 값을 가져오거나 설정합니다.
네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)
구문
‘선언
<BrowsableAttribute(False)> _
Public Property Enabled As Boolean
‘사용 방법
Dim instance As InkOverlay
Dim value As Boolean
value = instance.Enabled
instance.Enabled = value
[BrowsableAttribute(false)]
public bool Enabled { get; set; }
[BrowsableAttribute(false)]
public:
property bool Enabled {
bool get ();
void set (bool value);
}
/** @property */
/** @attribute BrowsableAttribute(false) */
public boolean get_Enabled()
/** @property */
/** @attribute BrowsableAttribute(false) */
public void set_Enabled(boolean value)
public function get Enabled () : boolean
public function set Enabled (value : boolean)
속성 값
형식: System.Boolean
InkOverlay 개체가 펜 입력을 수집하는지 여부입니다.
InkOverlay 개체가 펜 입력을 수집하면 true입니다.
InkOverlay 개체가 펜 입력을 보고하지 않으면 false입니다. 이러한 경우 펜 관련 이벤트가 발생하지 않습니다.
설명
펜 입력에는 잉크뿐 아니라 in-air 패킷, 범위 커서 이벤트 등이 포함될 수 있습니다.
InkOverlay 개체는 Microsoft Windows Vista, Windows XP Tablet PC Edition 또는 Windows XP Tablet PC Edition SDK가 설치되어 있는 Windows 2000, Windows Server 2003 또는 Windows XP의 모든 버전에서 잉크를 수집합니다. 그러나 필기 인식은 Windows XP Tablet PC Edition부터 지원됩니다. 모든 Windows 2000, Windows Server 2003 버전 또는 Windows XP Tablet PC Edition이 아닌 Windows XP 버전의 경우에는 Windows XP Tablet PC Edition SDK가 설치되어 있지 않으면 Enabled 속성이 false입니다.
활성화된 InkCollector 또는 InkOverlay(생성자에서 또는 SetWindowInputRectangle 메서드를 사용하여 설정)의 창 입력 사각형이 InkOverlay의 창 입력 사각형과 겹치면 COMException 예외가 throw됩니다.
참고
입력 사각형이 서로 겹쳐도 이러한 사각형 중 하나만 활성화되어 있으면 오류가 발생하지 않습니다.
컨트롤이 활성화되어 있지 않으면 이벤트를 받을 수 없습니다.
컨테이너 컨트롤의 Enabled 속성을 false로 설정하면 포함된 모든 컨트롤도 함께 비활성화됩니다.
개체에서 잉크를 수집하는 동안(CollectingInk 속성이 true일 때)에는 Enabled 속성을 false로 설정할 수 없습니다.
개체의 특정 속성 및 메서드를 설정하거나 호출하기 전에 Enabled 속성을 false로 설정해야 합니다. 지정된 속성을 변경하거나 지정된 메서드를 호출하려고 하면 오류가 발생합니다.
Enabled 속성을 먼저 false로 설정해야 다음 속성 및 메서드를 설정하거나 호출할 수 있습니다.
응용 프로그램을 종료하기 전에 InkOverlay 개체의 Enabled 속성을 false로 설정해야 합니다.
예제
이 C# 예제에서는 InkOverlay 개체를 만들어 활성화합니다.
using Microsoft.Ink;
//...
InkOverlay theInkOverlay = new InkOverlay(Handle);
theInkOverlay.Enabled = true;
//...
이 Microsoft Visual Basic.NET 예제에서는 InkOverlay 개체를 만들어 활성화합니다.
Imports Microsoft.Ink
'...
Dim theInkOverlay As New InkOverlay(Handle)
theInkOverlay.Enabled() = True
'...
플랫폼
Windows Vista
.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.
버전 정보
.NET Framework
3.0에서 지원