InkPicture.InkEnabled 속성

아티클
10/28/2008

업데이트: 2007년 11월

InkPicture 컨트롤이 펜 입력을 수집하는지 여부를 지정하는 값을 가져오거나 설정합니다.

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

구문

‘선언
<BrowsableAttribute(True)> _
Public Property InkEnabled As Boolean
‘사용 방법
Dim instance As InkPicture
Dim value As Boolean

value = instance.InkEnabled

instance.InkEnabled = value

[BrowsableAttribute(true)]
public bool InkEnabled { get; set; }

[BrowsableAttribute(true)]
public:
property bool InkEnabled {
    bool get ();
    void set (bool value);
}

/** @property */
/** @attribute BrowsableAttribute(true) */
public boolean get_InkEnabled()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_InkEnabled(boolean value)

public function get InkEnabled () : boolean
public function set InkEnabled (value : boolean)

속성 값

형식: System.Boolean
InkPicture 컨트롤이 펜 입력을 수집하면 true입니다. 기본값입니다.
InkPicture 컨트롤이 펜 입력을 보고하지 않으면 false입니다. 이러한 경우 펜 관련 이벤트가 발생하지 않습니다.

설명

펜 입력에는 잉크뿐 아니라 in-air 패킷, 범위 커서 이벤트 등이 포함될 수 있습니다.

InkPicture 컨트롤은 Microsoft® 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가 설치되어 있지 않으면 InkEnabled 속성이 항상 false입니다.

활성화된 InkCollector 또는 InkOverlay(생성자에서 또는 SetWindowInputRectangle 메서드를 사용하여 설정)의 창 입력 사각형이 InkPicture의 창 입력 사각형과 겹치면 COMException 예외가 throw됩니다.

참고

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

컨트롤이 활성화되어 있지 않으면 이벤트를 받을 수 없습니다.

컨테이너 컨트롤의 Enabled 속성을 false로 설정하면 포함된 모든 컨트롤도 함께 비활성화됩니다.

컨트롤에서 잉크를 수집하는 동안(CollectingInk 속성이 true일 때)에는 InkEnabled 속성을 false로 설정할 수 없습니다.

컨트롤의 특정 속성 및 메서드를 설정하거나 호출하기 전에 InkEnabled 속성을 false로 설정해야 합니다. 지정된 속성을 변경하거나 지정된 메서드를 호출하려고 하면 오류가 발생합니다.

InkEnabled 속성을 먼저 false로 설정해야 다음 속성 및 메서드를 설정하거나 호출할 수 있습니다.

속성:
- Ink
- MarginX
- MarginY
메서드:
- SetAllTabletsMode
- SetSingleTabletIntegratedMode

응용 프로그램을 종료하기 전에 InkPicture 컨트롤의 InkEnabled 속성을 false로 설정해야 합니다.

예제

다음 예제에서는 ButtonClick 이벤트에 대한 이벤트 처리기를 정의합니다. 이 이벤트가 발생하면 이벤트 처리기가 InkEnabled 속성 값을 전환하고 Button의 텍스트를 업데이트하여 다음 클릭으로 수행될 작업을 반영합니다.

' Event handler for the button's Click event.
Private Sub buttonToggle_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles buttonToggle.Click
    ' toggle the InkEnabled property and update button text
    mInkPicture.InkEnabled = Not mInkPicture.InkEnabled
    If mInkPicture.InkEnabled Then
        DirectCast(sender, Button).Text = "Disable Ink"
    Else
        DirectCast(sender, Button).Text = "Enable Ink"
    End If

End Sub

// Event handler for the button's Click event.
private void buttonToggle_Click(object sender, System.EventArgs e)
{
    // toggle the InkEnabled property and update button text
    mInkPicture.InkEnabled = !mInkPicture.InkEnabled;
    ((Button)sender).Text = (mInkPicture.InkEnabled) ? "Disable Ink" : "Enable Ink";
}