InkAnalyzerBase.SetStrokesType メソッド

2008-10-28

指定したストロークの型を変更します。

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

構文

'宣言
Public Sub SetStrokesType ( _
    strokeIds As Integer(), _
    strokeType As StrokeType _
)
'使用
Dim instance As InkAnalyzerBase
Dim strokeIds As Integer()
Dim strokeType As StrokeType

instance.SetStrokesType(strokeIds, strokeType)

public void SetStrokesType(
    int[] strokeIds,
    StrokeType strokeType
)

public:
void SetStrokesType(
    array<int>^ strokeIds, 
    StrokeType strokeType
)

public void SetStrokesType(
    int[] strokeIds,
    StrokeType strokeType
)

public function SetStrokesType(
    strokeIds : int[], 
    strokeType : StrokeType
)

パラメータ

strokeIds
型 : array<System.Int32[]
strokeType を割り当てるストロークのストローク識別子が含まれている配列。

strokeType
型 : System.Windows.Ink.AnalysisCore.StrokeType
ストロークに割り当てるストロークの型。

解説

ストロークの型が StrokeType 値 Unspecified の場合、インクアナライザはインク分析時にストロークを分類します。それ以外の場合は、アナライザはストロークで設定された型を使用します。

インクアナライザは、ストロークの型の値をインク分析の一部として設定しません。現在ストロークに割り当てられている型を取得するには、GetStrokeType を呼び出します。

ストロークが、未分類インクノードではないコンテキストノードに関連付けられている場合、このメソッドは同じ言語のストロークが含まれる未分類インクノードにストロークを移動します。そのようなコンテキストノードが存在しない場合、このメソッドは新しい未分類インクノードを作成して、ストロークをそれに追加します。未分類インクノードは、Type プロパティ値が UnclassifiedInk の ContextNodeBase です。

このメソッドがストロークを移動する場合、このメソッドはストロークの境界ボックスをインクアナライザの DirtyRegion にも追加します。

strokeType パラメータがストロークの現在の型と一致する場合、このメソッドはストロークを移動しません。

strokeIds で識別されたストロークがインクアナライザに関連付けられていない場合、このメソッドは識別子を無視します。

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

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

例

次の例では、ストロークの型を StrokeType 値 Writing に設定し、指定したノードのすべてのストロークのストロークロケールをフランス語に設定します。指定した ContextNodeBase、theNode が含まれている InkAnalyzerBase、theInkAnalyzerBase。

' For all strokes in the specified node or one of its descendants,
' set the stroke type to Writing and the stroke locale to French.
Dim theStrokeIds As Integer() = theNode.GetStrokeIds()
If 0 < theStrokeIds.Length Then
    theInkAnalyzerBase.SetStrokesType( _
        theStrokeIds, System.Windows.Ink.AnalysisCore.StrokeType.Writing)
    theInkAnalyzerBase.SetStrokesLanguageId(theStrokeIds, &H40C)
End If

// For all strokes in the specified node or one of its descendants,
// set the stroke type to Writing and the stroke locale to French.
int[] theStrokeIds = theNode.GetStrokeIds();
if (0 < theStrokeIds.Length)
{
    theInkAnalyzerBase.SetStrokesType(theStrokeIds,
        System.Windows.Ink.AnalysisCore.StrokeType.Writing);
    theInkAnalyzerBase.SetStrokesLanguageId(theStrokeIds, 0x040c);
}