InkAnalyzer.RemoveStrokes メソッド

2008-10-28

ストロークコレクションをインクアナライザから削除します。

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

構文

'宣言
Public Sub RemoveStrokes ( _
    strokesToRemove As Strokes _
)
'使用
Dim instance As InkAnalyzer
Dim strokesToRemove As Strokes

instance.RemoveStrokes(strokesToRemove)

public void RemoveStrokes(
    Strokes strokesToRemove
)

public:
void RemoveStrokes(
    Strokes^ strokesToRemove
)

public void RemoveStrokes(
    Strokes strokesToRemove
)

public function RemoveStrokes(
    strokesToRemove : Strokes
)

パラメータ

strokesToRemove
型 : Microsoft.Ink.Strokes
削除するストロークコレクション。

解説

このメソッドは InkAnalyzer から strokesToRemove を削除します。

このメソッドは、ストロークを参照するリーフコンテキストノードから strokesToRemove の各ストロークを削除します。コンテキストノードがどのストロークも参照しなくなった場合、このメソッドはコンテキストノードと、子ノードを持たなくなったすべての先祖ノードを削除します。

このメソッドは、コンテキストノードからストロークを削除した後、DirtyRegion を更新して、削除したストロークの境界ボックスを含めます。

このメソッドは、インクアナライザに関連付けられていないすべてのストロークを無視します。strokesToRemove のストロークが、インクアナライザに関連付けられていない場合、このメソッドはインクアナライザを更新せずに終了します。

strokesToRemove が nullnull 参照 (Visual Basic では Nothing) の場合、このメソッドは System.ArgumentNullException をスローします。

例

この例では、InkAnalyzer、theInkAnalyzer に関連付けられたすべてのストロークをインクアナライザから削除し、同時に theInkAnalyzer に関連付けられた Microsoft.Ink.Ink オブジェクトからも削除します。

' Get all the strokes associated with the ink analyzer.
Dim theStrokes As Microsoft.Ink.Strokes = Me.theInkAnalyzer.RootNode.Strokes

If Nothing IsNot theStrokes Then
    ' Remove the strokes from the analyzer.
    Me.theInkAnalyzer.RemoveStrokes(theStrokes)

    ' Deleted the strokes from the associated Ink object.
    Me.theInkAnalyzer.Ink.DeleteStrokes(theStrokes)
End If

// Get all the strokes associated with the ink analyzer.
Microsoft.Ink.Strokes theStrokes = this.theInkAnalyzer.RootNode.Strokes;

if (null != theStrokes)
{
    // Remove the strokes from the analyzer.
    this.theInkAnalyzer.RemoveStrokes(theStrokes);

    // Deleted the strokes from the associated Ink object.
    this.theInkAnalyzer.Ink.DeleteStrokes(theStrokes);
}