IInkAnalyzer::GetAnalysisHintsByName メソッド
IInkAnalyzer にアタッチされ、指定した名前を持つすべての分析ヒント IContextNode オブジェクトを取得します。
構文
HRESULT GetAnalysisHintsByName(
[in] BSTR hintName,
[out] IContextNodes **ppAnalysisHints
);
パラメーター
-
hintName [in]
-
検索するヒント名。
-
ppAnalysisHints [out]
-
指定した名前を持つ IInkAnalyzer 内の分析ヒント IContextNode オブジェクト。
戻り値
戻り値の説明については、「 クラスとインターフェイス - インク分析 の戻り値」を参照してください。
解説
注意事項
メモリ リークを回避するには、オブジェクトを使用する必要がなくなったときに、ppAnalysisHints で IUnknown::Release を呼び出します。
このような分析ヒント ノードが IInkAnalyzer にアタッチされていない場合、このメソッドは空のコレクションを返します。
分析ヒント ノードは、AnalysisHint のコンテキスト ノード タイプを持つ IContextNode です ( 「IContextNode::GetType 」および 「コンテキスト ノードの種類」を参照)。
ヒントにコンテキスト情報を追加するには、 IContextNode::AddPropertyData を使用し、 pPropertyDataId パラメーターを Analysis Hint Properties 定数のグローバル一意識別子 (GUID) のいずれかに設定します。
コンテキスト ノードで設定されているプロパティ値を見つけるには、 IContextNode::GetPropertyDataIds を使用します。 プロパティの値を検索するには、 IContextNode::GetPropertyData を使用します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
サポートなし |
ヘッダー |
|
[DLL] |
|