共用方式為


IInkAnalyzer::SearchWithLanguageId 方法

提供模糊、不區分大小寫的片語型搜尋,以搜尋已分析的書寫筆劃,以及分析已辨識類型的繪圖筆劃。

語法

HRESULT SearchWithLanguageId(
  [in]      BSTR  bstrPhraseToMatch,
  [in]      LONG  lSearchStringLanguageId,
  [in, out] ULONG *pulSearchResultCount,
  [out]     ULONG **ppulStrokeCountPerResult,
  [in, out] ULONG *pulStrokeIdsCount,
  [out]     ULONG **ppulStrokeIds
);

參數

bstrPhraseToMatch [in]

在目前分析筆劃的替代專案中找到的片語。

lSearchStringLanguageId [in]

與傳遞之字串相關聯的 LCID。 用來在內部轉換大小寫以支援不區分大小寫的比較。

pulSearchResultCount [in, out]

從搜尋傳回的結果數目上限。

ppulStrokeCountPerResult [out]

每個搜尋結果中筆劃數目的數位指標。

pulStrokeIdsCount [in, out]

ppulStrokeIds 中的筆劃標識碼數目。

ppulStrokeIds [out]

筆劃標識子陣列的指標,代表一組筆劃。

傳回值

如需傳回值的描述,請參閱 類別和介面 - 筆跡分析

備註

此搜尋會尋找多字和單字子字串。 會搜尋替代辨識結果和替代分割。

所有傳入字串都會轉換成單一大小寫,以便比較使用目前線程的 LCID 來執行這項轉換,以遵守文化案例慣例。

傳遞的字串會被視為片語。 文字和字元必須以指定的順序出現在筆劃的替代字元中。 片語的第一個和最後一個單字可能會比對為子字串(第一個字出現在替代詞的結尾,最後一個單字出現在一個字的開頭),但任何其他單字(片語內的單字)必須以整個單字的形式出現。

如果傳入的字串在字元之間沒有空格符,可以在替代的單一單字內的任何位置找到子字串。

只有字元之間沒有空格符,才會變更搜尋的結果。 不會忽略未以字元括住的空格符。 會忽略空格符的類型(字元之間的索引標籤或空格會提供相同的結果)。 空格符的數量並不重要 - 字元之間的一個空格或兩個空格會提供相同的結果。

搜尋不會產生 PopulateContextNode 事件。 只會搜尋已填入的筆劃。

需求

需求
最低支援的用戶端
Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器
不支援
頁首
IACom.h (也需要IACom_i.c)
DLL
IACom.dll

另請參閱

IInkAnalyzer