次の方法で共有

IInkAnalyzer::GetNodesFromTextRange メソッド

  • [アーティクル]

指定したコンテキスト ノードの指定したテキスト範囲に関連する IContextNode オブジェクトのコレクションを取得します。

構文

HRESULT GetNodesFromTextRange(
  [in, out] LONG          *plStart,
  [in, out] LONG          *plLength,
  [out]     IContextNodes **ppContextNodes,
  [in]      IContextNodes *pNodesToSearch = defaultvalue
);

パラメーター

plStart [in, out]

認識された文字列の pNodesToSearch 部分のテキスト範囲の先頭への参照。

plLength [in, out]

認識された文字列の pNodesToSearch 部分のテキスト範囲の長さへの参照。

ppContextNodes [out]

指定したコンテキスト ノードの指定したテキスト範囲に関連する IContextNode オブジェクトへのポインター。

pNodesToSearch [in]

検索を制限する IContextNode オブジェクト。

戻り値

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

解説

指定されたテキスト範囲は、IInkAnalyzer 全体の認識された文字列ではなく、IInkAnalyzer の認識された文字列の pNodesToSearch 部分に対して相対的である必要があります。

このメソッドは、テキスト範囲を最も近い単語の境界に拡張することで、 plStart パラメーターと plLength パラメーターの値を変更します。

たとえば、認識された文字列が "I am late" で、 plStart に 6、 plLength に 1 のパラメーター値を使用してこのメソッドを呼び出します。これは、"late" の文字 "a" に対応します。このメソッドは、"late" という単語に対応する単一の IContextNode、InkWord、または TextWord を含むコレクションを返します。 この例では、このメソッドは plStart の値を 5 に、 plLength の値を 4 に変更します。これは"late" という単語に対応します。

注意

plStart パラメーターは、pNodesToSearch パラメーターの認識された文字列に対する相対値です。

必要条件

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

関連項目

IInkAnalyzer