InkAnalyzerBase.SetStrokesLanguageId メソッド

2008-10-28

指定したストロークのロケール識別子を変更します。

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

構文

'宣言
Public Sub SetStrokesLanguageId ( _
    strokeIds As Integer(), _
    languageId As Integer _
)
'使用
Dim instance As InkAnalyzerBase
Dim strokeIds As Integer()
Dim languageId As Integer

instance.SetStrokesLanguageId(strokeIds, _
    languageId)

public void SetStrokesLanguageId(
    int[] strokeIds,
    int languageId
)

public:
void SetStrokesLanguageId(
    array<int>^ strokeIds, 
    int languageId
)

public void SetStrokesLanguageId(
    int[] strokeIds,
    int languageId
)

public function SetStrokesLanguageId(
    strokeIds : int[], 
    languageId : int
)

パラメータ

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

languageId
型 : System.Int32
指定したストロークに割り当てる言語識別子。

解説

ストロークのロケールは、AddStroke または AddStrokes を呼び出すことによりストロークを追加したときに設定されます。現在ストロークに割り当てられているロケールを取得するには、GetStrokeLanguageId を呼び出します。

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

このメソッドが、未分類インクノードではないコンテキストノードからストロークを移動した場合、このメソッドはストロークの境界ボックスもインクアナライザの DirtyRegion に追加します。

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

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);
}