InkCollector.Handle 속성

아티클
11/04/2008

업데이트: 2007년 11월

InkCollector 개체가 연결된 창의 핸들을 가져오거나 설정합니다.

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

구문

‘선언
Public Property Handle As IntPtr
‘사용 방법
Dim instance As InkCollector
Dim value As IntPtr

value = instance.Handle

instance.Handle = value

public IntPtr Handle { get; set; }

public:
property IntPtr Handle {
    IntPtr get ();
    void set (IntPtr value);
}

/** @property */
public IntPtr get_Handle()
/** @property */
public  void set_Handle(IntPtr value)

public function get Handle () : IntPtr
public function set Handle (value : IntPtr)

속성 값

형식: System.IntPtr
InkCollector 개체가 연결된 창의 핸들입니다.

값	의미
nullNull 참조(Visual Basic의 경우 Nothing)	AttachedControl 도 nullNull 참조(Visual Basic의 경우 Nothing)이면 InkCollector 개체는 창에 연결되지 않습니다.
System.Windows.Forms.Control.Handle	InkCollector 개체가 연결된 창의 핸들입니다.

설명

AttachedControl 또는 Handle 속성을 설정해야 InkCollector 개체를 활성화할 수 있습니다.

InkCollector 개체를 컨트롤에 연결한 경우 이 속성을 설정하면 InkCollector 개체가 창에 연결되며 AttachedControl 속성이 지워집니다.

참고

이 속성을 설정하기 전에 InkCollector를 비활성화해야 합니다. InkCollector를 비활성화하려면 Enabled 속성을 false로 설정합니다. 그런 후에 이 속성을 설정하고 Enabled 속성을 true로 설정하여 개체를 다시 활성화할 수 있습니다.

응용 프로그램에서 AttachedControl 속성과 Handle 속성을 사용하는 경우 인터넷 영역에서 응용 프로그램을 실행하면 보안 예외가 발생합니다. Handle 속성은 인터넷 영역의 부분 신뢰 환경에서는 유효하지 않아 Tablet PC 운영 체제에서 AttachedControl 속성으로 되돌려지기 때문입니다.

보안 정보:
부분 신뢰 환경에서 사용하는 경우 이 속성에 SecurityPermissionFlag.UnmanagedCode 권한 및 InkCollector에서 요구하는 권한이 필요합니다. 자세한 내용은 Security And Trust를 참조하십시오.

예제

다음 예제에서는 InkCollector 개체 또는 InkOverlay 개체가 새 컨트롤에서 잉크를 수집하도록 지시하는 데 사용할 수 있는 메서드를 보여 줍니다.

Private Sub SwitchInkObjectHandle(ByVal collectingControl As Control)
    ' mInkObject can be InkCollector or InkOverlay
    mInkObject.Enabled = False
    ' setting the Handle property sets the AttachedControl property to null
    mInkObject.Handle = collectingControl.Handle
    mInkObject.Enabled = True
End Sub

private void SwitchInkObjectHandle(Control collectingControl)
{
    // mInkObject can be InkCollector or InkOverlay
    mInkObject.Enabled = false;
    // setting the Handle property sets the AttachedControl property to null
    mInkObject.Handle = collectingControl.Handle;
    mInkObject.Enabled = true;
}