Метод IACList::Expand (shlobj_core.h)

Запрашивает, чтобы клиент автозаполнения создавал строки-кандидаты, связанные с указанным элементом в его пространстве имен.

Синтаксис

HRESULT Expand(
  [in] PCWSTR pszExpand
);

Параметры

[in] pszExpand

Тип: PCWSTR

Указатель на строку Юникода, завершаемую null, которая должна быть развернута объектом автозавершения.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Объект автозаполнения вызывает этот метод при вводе разделителя в элементе управления редактированием. Если строка, на которую указывает pszExpand , соответствует элементу в пространстве имен клиента автозавершения, клиент создает строки для тех элементов, которые непосредственно входят в pszExpand в иерархии пространства имен. Клиент возвращает эти строки в следующий раз, когда объект автозавершения вызывает интерфейс IEnumString клиента.

Например, если пространство имен клиента состоит из всех файлов и папок на диске C:, а для pszExpand задано значение "C:\Program Files", клиент должен создать список строк, соответствующих полным путям к файлам и вложенным папкам "C:\Program Files".

Требования

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

IACList