# com.autoComplete 库模块帮助文档

[🅰 使用范例](https://www.aardio.com/zh-cn/doc/example/Windows/edit/autoComplete.html) [📄 autoComplete.dll 源码](https://www.aardio.com/zh-cn/doc/example/Languages/CPP/com.autoComplete.html)

## com 成员列表 <a id="com" href="#com">&#x23;</a>

### com.autoComplete <a id="com.autoComplete" href="#com.autoComplete">&#x23;</a>
自动完成接口。  
仅适用于 edit 控件（单行模式），并不兼容 richedit 控件。

创建自动完成对象

### com.autoComplete() <a id="com.autoComplete" href="#com.autoComplete">&#x23;</a>
[返回对象:ComAompleteObject](#ComAompleteObject)

### com.autoComplete(edit,option) <a id="com.autoComplete" href="#com.autoComplete">&#x23;</a>
参数 @edit 指定 edit 控件对象（或启用编辑模式的 plus 控件）。  
参数 @option 可选用数值指定默认选项，可用选项请参考 setOption 函数说明。  
一般不需要指定 @option 。

## ComAompleteObject 成员列表 <a id="ComAompleteObject" href="#ComAompleteObject">&#x23;</a>

### ComAompleteObject.enable() <a id="ComAompleteObject.enable" href="#ComAompleteObject.enable">&#x23;</a>
启用或禁用自动完成，使用参数 @1 可指定 true 或 false 。

### ComAompleteObject.hide() <a id="ComAompleteObject.hide" href="#ComAompleteObject.hide">&#x23;</a>
临时隐藏自动完成列表。  
调用此函数后会启用自动完成功能。  
默认会在回车时调用此功能。

### ComAompleteObject.setOption() <a id="ComAompleteObject.setOption" href="#ComAompleteObject.setOption">&#x23;</a>
使用参数 @1 指定一个数值更新自动完成选项。  
可用选项请参考[文档](https://learn.microsoft.com/windows/win32/api/shldisp/ne-shldisp-autocompleteoptions)  
一般没必要修改 option 。

### ComAompleteObject.setStrings(字符串数组) <a id="ComAompleteObject.setStrings" href="#ComAompleteObject.setStrings">&#x23;</a>
将参数 @1 指定的字符串数组设置为 edit 控件的自动完成列表。  
必须在用户输入前设置好所有需要提示的字符串，如果正在输入时变更字符串列表不会实时生效。

### ComAompleteObject.show() <a id="ComAompleteObject.show" href="#ComAompleteObject.show">&#x23;</a>
显示下拉列表。  
此函数模拟发送 _VK_DOWN 按键的 _WM_KEYDOWN 消息，  
只有启用了 _ACO_UPDOWNKEYDROPSLIST 选项（默认设置），  
并在文本框已获得焦点时才会有效。
