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