Ink.InkDeleted イベント

[アーティクル]
10/28/2008

Stroke オブジェクトが Ink オブジェクトから削除されたときに発生します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Event InkDeleted As StrokesEventHandler
'使用
Dim instance As Ink
Dim handler As StrokesEventHandler

AddHandler instance.InkDeleted, handler

public event StrokesEventHandler InkDeleted

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

/** @event */
public void add_InkDeleted (StrokesEventHandler value)
/** @event */
public void remove_InkDeleted (StrokesEventHandler value)

JScript では、イベントは使用できません。

解説

イベントハンドラは、このイベントについてのデータを格納している StrokesEventArgs 型の引数を受け取ります。

StrokesEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを指定します。イベントをイベントハンドラに関連付けるには、デリゲートのインスタンスをイベントに追加します。デリゲートを削除しない限り、そのイベントが発生すると常にイベントハンドラが呼び出されます。

InkOverlay オブジェクト、または InkPicture コントロール (この場合 EditingMode は Delete と等しく、かつ EraserMode は StrokeErase と等しい) を使用してストロークを消しゴムで消すと、次の一連のイベントが発生します。

InkDeleted
InkAdded
InkDeleted

基底のコードにより、消しゴムを追跡するための非表示の内部ストロークが追加されるため、追加の InkAdded イベントと InkDeleted イベントが発生します。

InkDeleted イベントは、削除モードの場合のみではなく選択モードの場合でも発生します。このためには編集モードを監視し (設定が必要)、イベントを解釈する前にモードを認識する必要があります。この要件の利点は、プラットフォームイベントの認識がより容易になることにより、プラットフォーム上での新しい技術の導入がより可能になることです。

例

この例では、削除されたストロークに関する情報を InkDeleted イベントハンドラによってリストボックスコントロールに書き込まれます。

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

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

        }
    }
}