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 或更高版本)

另请参阅

IAutoComplete