Win32编程点滴 - 玩转AutoComplete

Win32编程点滴 - 玩转AutoComplete2010-01-10 cnblogs GreatestSHAutoComplete

要最简单地实现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_USERSoftwareMicrosoftWindowsCurrentVersionExplorerAutoComplete

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是返回的字符数。并要加上结尾""的 字节
    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 。