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