Ink.InkAdded 이벤트

아티클
11/04/2008

업데이트: 2007년 11월

Ink 개체에 Stroke 개체가 추가될 때 발생합니다.

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

구문

‘선언
Public Event InkAdded As StrokesEventHandler
‘사용 방법
Dim instance As Ink
Dim handler As StrokesEventHandler

AddHandler instance.InkAdded, handler

public event StrokesEventHandler InkAdded

public:
 event StrokesEventHandler^ InkAdded {
    void add (StrokesEventHandler^ value);
    void remove (StrokesEventHandler^ value);
}

/** @event */
public void add_InkAdded (StrokesEventHandler value)
/** @event */
public void remove_InkAdded (StrokesEventHandler value)

JScript에서는 이벤트를 지원하지 않습니다.

설명

이벤트 처리기는 이 이벤트에 대한 데이터가 들어 있는 StrokesEventArgs 형식의 인수를 받습니다.

StrokesEventHandler 대리자를 만드는 경우 이벤트를 처리하는 메서드를 식별합니다. 이벤트를 이벤트 처리기와 연결하려면 대리자의 인스턴스를 해당 이벤트에 추가합니다. 대리자를 제거하지 않는 경우 이벤트가 발생할 때마다 이벤트 처리기가 호출됩니다.

InkOverlay 개체 또는 InkPicture 컨트롤(이 경우 EditingMode는 Delete와 같고 EraserMode는 StrokeErase와 같음)을 사용하고 지우개를 스트로크 위로 전달하는 경우 다음과 같은 순서로 이벤트가 발생합니다.

기본 코드에서 표시되지 않는 내부 스트로크를 추가하여 지우개를 추적하기 때문에 추가 InkAdded 및 InkDeleted 이벤트가 발생합니다.

잉크를 삽입하는 경우뿐만 아니라 선택 또는 지우기 모드인 경우에도 InkAdded 이벤트가 발생합니다. 따라서 사용자가 설정하는 편집 모드는 사용자가 직접 모니터링해야 하며 이벤트를 해석하기 전에 모드를 알고 있어야 합니다. 이러한 요구 사항을 적용하면 플랫폼 이벤트를 더 효율적으로 인식하여 플랫폼을 보다 자유롭게 활용할 수 있습니다.

예제

이 예제에서 InkAdded 이벤트 처리기는 추가된 스트로크에 대한 정보를 목록 상자 컨트롤에 씁니다.

Private Sub Ink_InkAdded(ByVal sender As Object, ByVal e As StrokesEventArgs)
    ' since this event fires in all modes, we will check EditingMode
    ' and examine the StrokeIds only if we are currently in mode: InkOverlayEditingMode.Ink 
    If InkOverlayEditingMode.Ink = Me.mInkOverlay.EditingMode Then
        For Each id As Integer In e.StrokeIds
            Me.listBoxStrokeId.Items.Add("Added ID:" + id.ToString())
        Next
    End If
End Sub

private void Ink_InkAdded(object sender, StrokesEventArgs e)
{
    // since this event fires in all modes, we will check EditingMode
    // and examine the StrokeIds only if we are currently in mode: InkOverlayEditingMode.Ink 
    if (InkOverlayEditingMode.Ink == this.mInkOverlay.EditingMode)
    {
        foreach (int id in e.StrokeIds)
        {
            this.listBoxStrokeId.Items.Add("Added ID:" + id.ToString());

        }
    }
}