IAutoComplete::Init 方法 (shldisp.h)
初始化自动完成对象。
语法
HRESULT Init(
[in] HWND hwndEdit,
[in] IUnknown *punkACL,
[in, optional] LPCWSTR pwszRegKeyPath,
[in, optional] LPCWSTR pwszQuickComplete
);
参数
[in] hwndEdit
类型:HWND
将为其启用自动完成的系统编辑控件窗口的句柄。
[in] punkACL
类型: IUnknown*
指向字符串列表对象的 IUnknown 接口的指针,该对象为已完成的字符串生成候选项。 对象必须公开 IEnumString 接口。
[in, optional] pwszRegKeyPath
类型: LPCWSTR
指向可选的以 null 结尾的 Unicode 字符串的指针,该字符串提供注册表路径(包括值名称),其中格式字符串存储为 REG_SZ 值。 自动完成对象首先查找 HKEY_CURRENT_USER下的路径。 如果失败,它会尝试 HKEY_LOCAL_MACHINE。 有关格式字符串的讨论,请参阅 pwszQuickComplete 的定义。
[in, optional] pwszQuickComplete
类型: LPCWSTR
指向以 null 结尾的可选 Unicode 字符串的指针,该字符串指定当用户输入文本并按 Ctrl+ENTER 时要使用的格式。 将此参数设置为 NULL 可禁用快速完成。 否则,autocomplete 对象将 pwszQuickComplete 视为 StringCchPrintf 格式字符串,将编辑框中的文本视为其关联的参数,以生成新字符串。 例如,将 pwszQuickComplete 设置为 “http://www.%s.com/"。 当用户在编辑框中输入“MyURL”并按 Ctrl+Enter 时,编辑框中的文本将更新为“http://www.MyURL.com/"”。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | shldisp.h |
DLL | Shell32.dll (5.0 或更高版本) |