TSF 响应按键

最新推荐文章于 2022-12-12 22:17:10 发布

原创最新推荐文章于 2022-12-12 22:17:10 发布 · 409 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#input

C++ 专栏收录该内容

22 篇文章

订阅专栏

本文介绍了CStringRange类作为无/0结尾字符串类型的使用方法，并详细解释了CCompositionProcessorEngine类如何响应按键操作来更新候选字列表的过程。同时，文中还探讨了CTableDictionaryEngine类收集候选字的具体实现。

CStringRange 是一个没有/0结尾的字符串类型，有两个成员：

DWORD_PTR _stringBufLen;         // Length is in character count.
const WCHAR *_pStringBuf;    // Buffer which is not add zero terminate.

CStringRange用 .Set() 赋值（两种方法），.Get() 取值，还可以 .GetLength()。

CCompositionProcessorEngine 是一个响应按键的类。它有一个成员： CStringRange _keysrokeBuffer，当按键后，首先改变 _keystrokeBuffer ，然后在 GetCandidateList() 里用 _pTableDictionaryEngine->CollectWord(&_keystrokeBuffer, pCandidateList) 来改变候选字列表。_pTableDictionaryEngine 也是 CCompositionProcessorEngine 的成员，而 pCandidateList 是传入的指针。

CTableDictionaryEngine 是一个获取候选字的类，有4种方法：

CollectWord(_In_ CStringRange *pKeyCode, _Inout_ CSampleImeArray<CStringRange> *pWordStrings)
CollectWord(_In_ CStringRange *pKeyCode, _Inout_ CSampleImeArray<CCandidateListItem> *pItemList)
CollectWordForWildcard(_In_ CStringRange *pKeyCode, _Inout_ CSampleImeArray<CCandidateListItem> *pItemList)
CollectWordFromConvertedStringForWildcard(_In_ CStringRange *pString, _Inout_ CSampleImeArray<CCandidateListItem> *pItemList)

CandList 是一个以结构体 CCandidateListIterm 为元素的数组（Array），CCandidateListIterm 有两个成员：

CStringRange _ItemString;
CStringRange _FindKeyCode;

给 CandList 赋值的方法：

CStringRange str1;
CStringRange str2;
CCandidateListItem* pLI = nullptr;
pLI = pItemList->Append();
if (pLI){
    pLI->_ItemString.Set(str1);
    pLI->_FindKeyCode.Set(str2.Get(), str2.GetLength());
}