IInkAnalyzer::SetStrokesLanguageId メソッド
指定したストロークのロケール識別子を変更します。
構文
HRESULT SetStrokesLanguageId(
[in] ULONG ulStrokeIdCount,
[in] LONG *plStrokes,
[in] LONG lStrokesLCID
);
パラメーター
-
ulStrokeIdCount [in]
-
plStrokes 内のストローク識別子の数。
-
plStrokes [in]
-
ロケール識別子を割り当てるストロークの識別子の配列。
-
lStrokesLCID [in]
-
ストロークに割り当てるロケール識別子。
戻り値
戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。
解説
ストロークのロケールは、IInkAnalyzer::AddStroke メソッド、IInkAnalyzer::AddStrokeForLanguage メソッド、IInkAnalyzer::AddStrokes メソッド、または IInkAnalyzer::AddStrokesForLanguage メソッドを呼び出すことによって、ストロークを追加するときに設定されます。 ストロークに現在割り当てられているロケールを取得するには、 IInkAnalyzer::GetStrokeLanguageId メソッドを呼び出します。
指定したストロークは、同じ言語のストロークを含む未分類のインク ノード ( IContextNode::GetType を参照) に移動されます。 このような IContextNode が存在しない場合、このメソッドは新しい未分類のインク ノードを作成し、ストロークをそのノードに移動します。 未分類のインク ノードは、UnclassifiedInk 型の IContextNode です。
このメソッドは、未分類のインク ノードではない IContextNode からストロークを移動する場合、このメソッドは、インク アナライザーのダーティ領域にストロークの境界ボックスも追加します (「IInkAnalyzer::GetDirtyRegion メソッド」を参照してください)。
lStrokeLCID パラメーターがストロークの現在の言語識別子と一致する場合、このメソッドはストロークを移動しません。
指定したストロークが IInkAnalyzer に関連付けられていない場合、このメソッドは識別子を無視します。
指定したストロークのいずれも IInkAnalyzer に関連付けられているストロークを識別しない場合、このメソッドは IInkAnalyzer を更新せずに を返します。
strokeIds が NULL の場合、このメソッドはエラー コードを返 します。
言語識別子の詳細については、「 言語識別子の定数と文字列」を参照してください。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| Header |
|
| [DLL] |
|