Поделиться через


Метод 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 или более поздняя)

См. также раздел

IAutoComplete