Ink.InkAdded 事件

项目
11/04/2008

当 Stroke 对象添加到 Ink 对象时发生。

命名空间： 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());

        }
    }
}