Метод 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
Указатель на необязательную строку Юникода с пустым завершением, которая предоставляет путь к реестру, включая имя значения, где строка формата хранится в виде значения REG_SZ . Объект автозаполнения сначала ищет путь в HKEY_CURRENT_USER. В случае сбоя выполняется попытка HKEY_LOCAL_MACHINE. Описание строки формата см. в определении pwszQuickComplete.
[in, optional] pwszQuickComplete
Тип: LPCWSTR
Указатель на необязательную строку Юникода с пустым завершением, которая указывает формат, который будет использоваться, если пользователь вводит текст и нажимает клавиши CTRL+ВВОД. Присвойте этому параметру значение NULL , чтобы отключить быстрое завершение. В противном случае объект автозаполнения обрабатывает pwszQuickComplete как строку формата StringCchPrintf , а текст в поле редактирования — как связанный аргумент для создания новой строки. Например, задайте для pwszQuickComplete значение "http://www.%s.com/". Когда пользователь вводит "MyURL" в поле редактирования и нажимает клавиши CTRL+ВВОД, текст в поле редактирования обновляется на "http://www.MyURL.com/".
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | shldisp.h |
DLL | Shell32.dll (версия 5.0 или более поздняя) |