Win32编程点滴 - 玩转AutoComplete

核心提示：SHAutoComplete要最简单地实现AutoComplete，只要下面那样调用ShAutoComplete函数即可：SHAutoComplete(GetDlgItem (hDlg,IDC_EDIT2),SHACF_FILESYSTEM|SHACF_AUTOSUGGEST_FORCE_ON);SHAutoCompl

SHAutoComplete

要最简单地实现AutoComplete，只要下面那样调用ShAutoComplete函数即可：

SHAutoComplete(GetDlgItem (hDlg,IDC_EDIT2),SHACF_FILESYSTEM|SHACF_AUTOSUGGEST_FORCE_ON);

SHAutoComplete的第一个参数，是edit控件的句柄（或者是ComboBox中edit控件的句柄）。第二个参 数是一些flag，来控制提示的内容来自于文件系统（SHACF_FILESYSTEM等）还是历史url地址 （SHACF_URLHISTORY,SHACF_URLMRU等），或者全部。同时，还可以控制是否强制启用或关闭AutoAppend 和AutoSuggest功能。这两种功能的默认设置在ie的设置程序中或在注册表中：

HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\AutoComplete

AutoAppend 指的是根据你当前输入的内容，自动插入剩余的部分。例如：在AutoComplete的系统中 存在apple这个词条，那么当你键入app的时候，则系统会自动插入剩下的le，并将le以选中的方式显示 。类似于：app|le　　

AutoSuggest 启用的话，会自动出现下列表框显示候选的内容。

最后，不要忘记在程序开头调用CoInitialize，因为这东西和com有关。

自定义AutoComplete

SHAutoComplete的功能是十分的局限的，只能提供文件系统或url地址的自动完成。在大部分情况下 ，我们需要对自动完成的内容自定义。这时，我们需要的是shell提供的AutoComplete对象，并实现 IEnumString接口。简单的代码如下：

IAutoComplete　*　pac;
CoCreateInstance(CLSID_AutoComplete,NULL,CLSCTX_INPROC_SERVER,IID_IAutoComplete,(void**) &pac);
pac->Init(GetDlgItem(IDC_EDIT3),<你实现的IEnumString指针>,0,0);

然后，设置一些参数，比如：是否启用AutoAppend，AutoSuggest等：

IAutoComplete　*　pac2;
pac->QueryInterface(IID_IAutoComplete2,(void**)&pac2);
pac2->SetOptions(ACO_AUTOSUGGEST|ACO_AUTOAPPEND|ACO_UPDOWNKEYDROPSLIST);

最后，说明一下IEnumString的实现。IEnumString类似于大部分的IEnumXXXX本身非常简单，唯一需 要提一下的就是IEnumString::Next返回字符串需要调用CoTaskMemAlloc分配内存。代码如下：

STDMETHOD(Next(　ULONG　celt,LPOLESTR　*　rgelt,ULONG　*　pceltFetched))
{
　　ULONG　i=0;
　　if　(pceltFetched)*pceltFetched=0;
　　for　(;m_idx<(int)m_vec.GetCount()　&&　i<celt;++i,++m_idx)
　　{
　　　　//注意CoTaskMemAlloc接受的参数是字节数，GetLength是返回的字符数。并要加上结尾'\0'的 字节
　　　　rgelt[i]　=(LPOLESTR)CoTaskMemAlloc(2　+　m_vec[m_idx].GetLength()　*　2);
　　　　wcscpy(rgelt[i],m_vec[m_idx]);
　　　　if　(pceltFetched)　++(*pceltFetched);
　　}
　　return　i==celt?S_OK:S_FALSE;
}

这样，遍完成了自定义的AutoComplete。很简单，不是吗？

更进一步

如果候选的内容比较多，为了提高性能，可以再实现IACList接口。IACList只有一个方法：

HRESULT Expand(LPCWSTR pszExpand);

每次Expand被调用的时候，便生成一个pszExpand开头的候选列表。之后IEnumString接口的方法被调 用的时候，就从这个列表中取字符串。

例如：做一个文件系统的自动完成。用户输入"C:\"，然后Expand(L"C:\\")被 调用，则枚举C:\下面所有文件保存起来，然后IEnumString的方法则返回这些文件的路径。

另外，windows还提供的Compound AutoComplete等等这些组件。关于这些，请看Using Autocomplete 。