InkAnalyzerBase.SetStrokeLanguageId メソッド

2008-10-28

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

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

構文

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

instance.SetStrokeLanguageId(strokeId, _
    languageId)

public void SetStrokeLanguageId(
    int strokeId,
    int languageId
)

public:
void SetStrokeLanguageId(
    int strokeId, 
    int languageId
)

public void SetStrokeLanguageId(
    int strokeId,
    int languageId
)

public function SetStrokeLanguageId(
    strokeId : int, 
    languageId : int
)

パラメータ

strokeId
型 : System.Int32
ロケール識別子を割り当てるストローク識別子。

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

解説

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

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

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

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

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

例

次の例では、指定したストロークのロケール識別子をチェックし、まだ日本語に設定されていない場合は日本語に設定します。InkAnalyzerBase、theInkAnalyzerBase には、ストローク識別子 theStrokeId のストロークデータが含まれています。

' If the specified stroke is not set to Japanese, 0x0011,
' Set the stroke's locale to Japanese.
Dim languageId As Integer = _
    theInkAnalyzerBase.GetStrokeLanguageId(theStrokeId)
If &H11 <> languageId Then
    theInkAnalyzerBase.SetStrokeLanguageId(theStrokeId, &H11)
End If

// If the specified stroke is not set to Japanese, 0x0011,
// Set the stroke's locale to Japanese.
int languageId = theInkAnalyzerBase.GetStrokeLanguageId(theStrokeId);
if (0x0011 != languageId)
{
    theInkAnalyzerBase.SetStrokeLanguageId(theStrokeId, 0x0011);
}