IInkAnalyzer::SetStrokesType メソッド
指定したストロークの種類を変更します。
構文
HRESULT SetStrokesType(
[in] ULONG strokeIdCount,
[in] LONG *plStrokes,
[in] StrokeType StrokeType
);
パラメーター
-
strokeIdCount [in]
-
plStrokes 内のストローク識別子の数。
-
plStrokes [in]
-
StrokeType を割り当てるストロークのストローク識別子を含む配列。
-
StrokeType [in]
-
ストロークに割り当てる StrokeType 値。
戻り値
戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。
解説
ストロークの種類が StrokeType 値 StrokeType_Unclassified場合、 IInkAnalyzer はインク分析中にストロークを分類します。 それ以外の場合、 IInkAnalyzer はストロークに設定された型を使用します。
IInkAnalyzer では、インク分析の一部としてストロークの種類の値は設定されません。 ストロークの種類を指定または変更するには、 IInkAnalyzer::SetStrokeType メソッド または IInkAnalyzer::SetStrokesType メソッドを使用します。
未分類のインク ノードではない IContextNode にストロークが関連付けられている場合 ( 「IContextNode::GetType」を参照)、このメソッドは、同じ言語のストロークを含む未分類のインク ノードにストロークを移動します。 このようなコンテキスト ノードが存在しない場合、このメソッドは新しい未分類のインク ノードを作成し、ストロークを追加します。 未分類のインク ノードは、UnclassifiedInk 型の IContextNode です。
このメソッドが、未分類のインク ノードではない IContextNode からストロークを移動する場合、このメソッドは、インク アナライザーのダーティ領域にストロークの境界ボックスも追加します (「IInkAnalyzer::GetDirtyRegion メソッド」を参照)。
StrokeType パラメーターがストロークの現在の型と一致する場合、このメソッドはストロークを移動しません。
strokeIds で識別されたストロークが IInkAnalyzer に関連付けられていない場合、このメソッドは識別子を無視します。
指定したストロークのいずれも IInkAnalyzer に関連付けられているストロークを識別しない場合、このメソッドは IInkAnalyzer を更新せずに を返します。
NodeTypeAndProperties が確認された ContextNode に関連付けられているストロークにストロークの種類を設定すると、InvalidOperationException が発生します。
plStrokes が NULL の場合、このメソッドはエラー コードを返します。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| Header |
|
| [DLL] |
|