InkAnalyzer.RemoveStroke メソッド

2008-10-28

Stroke をインクアナライザから削除します。

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

構文

'宣言
Public Sub RemoveStroke ( _
    strokeToRemove As Stroke _
)
'使用
Dim instance As InkAnalyzer
Dim strokeToRemove As Stroke

instance.RemoveStroke(strokeToRemove)

public void RemoveStroke(
    Stroke strokeToRemove
)

public:
void RemoveStroke(
    Stroke^ strokeToRemove
)

public void RemoveStroke(
    Stroke strokeToRemove
)

public function RemoveStroke(
    strokeToRemove : Stroke
)

パラメータ

strokeToRemove
型 : System.Windows.Ink.Stroke
削除するストローク。

解説

RemoveStroke は、InkAnalyzer から strokeToRemove を削除します。

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

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

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

このメソッドは、strokeToRemove が nullnull 参照 (Visual Basic では Nothing) のときに ArgumentNullException をスローします。

例

この例では、Stroke、theStroke が、左側の境界が 32 ビット符号付き整数 leftBound より小さい境界ボックスを持つかどうかを判定します。持つ場合は、theInkAnalyzer という名前の InkAnalyzer から theStroke を削除します。

' Remove the stroke if its bounding box falls outside of the left bound.
If Not (theStroke Is Nothing) AndAlso theStroke.GetBounds().Left < leftBound Then
    Me.theInkAnalyzer.RemoveStroke(theStroke)
End If

// Remove the stroke if its bounding box falls outside of the left bound.
if (theStroke != null && theStroke.GetBounds().Left < leftBound)
{
    this.theInkAnalyzer.RemoveStroke(theStroke);
}