IContextNode::Confirm メソッド

  • [アーティクル]

確認の種類を変更します。これは、 IInkAnalyzer オブジェクトが IContextNode に関して変更できる内容を制御します。

構文

HRESULT Confirm(
  [in] ConfirmationType confirmedType
);

パラメーター

confirmedType [in]

ノードに適用される ConfirmationType 。

戻り値

戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。

解説

このメソッドを使用して、 IInkAnalyzer がストロークを正しく分析したことをエンド ユーザーが確認できるようにします。 IContextNode::Confirm が呼び出された後、IInkAnalyzer は、後の分析中にこれらのストロークの IContextNode オブジェクトを変更しません。

IContextNode::ユーザーが分析結果を確認し、後の分析中に IInkAnalyzer で IContextNode を変更したくない場合に確認します。 たとえば、ユーザーが "to" という単語を書き込み、アプリケーションが IInkAnalyzer::Analyze メソッドを呼び出すと、インク アナライザーは"to" の値を持つ InkWord ノードを生成します。 その後、ユーザーが "to" の後に "me" を 1 つの単語として追加し、アプリケーションが IInkAnalyzer::Analyze メソッド をもう一度呼び出した場合、インク アナライザーは前の InkWord ノードを削除し、値 "tome" を持つ新しい InkWord ノードを作成できます。 ただし、IInkAnalyzer::Analyze メソッドを初めて呼び出した後、アプリケーションは、ConfirmationType 値 NodeTypeAndProperties を使用して InkWord ノードの IContextNode::Confirm を呼び出し、ユーザーが "me" を追加する前に、アプリケーションが IInkAnalyzer::Analyze メソッドを呼び出しても、インク アナライザーは "to" ノードを削除または変更しません。 代わりに、インク アナライザーは、"to" と "me" の 2 つの InkWord ノードを認識できます。

IContextNode では 、InkWord 型と InkDrawing 型のオブジェクトのみを確認できます ( 「コンテキスト ノードの種類」を参照)。 IContextNode::Confirm は、ノードがリーフ ノードでない場合に E_INVALIDARG を返します。

IInkAnalyzer::RemoveStroke メソッド と IInkAnalyzer::RemoveStrokes メソッド は、ストローク データを削除するノードを確認しません。

IContextNode::SetStrokes、IInkAnalyzer::SetStrokesType、および IInkAnalyzer::SetStrokeType は、IContextNode オブジェクトが既に確認されている場合にCORE_E_INVALIDOPERATIONを返します。

IContextNode::ReparentStrokeByIdToNode は、ソース ノードまたは宛先ノードのいずれかが確認された場合にエラーを返します。

必要条件

要件 値
サポートされている最小のクライアント
 Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
ヘッダー
IACom.h (IACom_i.c も必要)
[DLL]
IACom.dll

関連項目

IContextNode

IContextNode::IsConfirmed

インク分析リファレンス