Функция обратного вызова LPFNVIEWCALLBACK (shlobj_core.h)

Статья
03/05/2024

[Этот интерфейс поддерживается в Windows XP с пакетом обновления 2 (SP2) и Windows Server 2003. В последующих версиях Windows она может быть неподдерживаема.]

Определяет прототип для функции обратного вызова, используемой объектом представления системных папок. Эта функция по существу дублирует функциональные возможности IShellFolderViewCB.

Синтаксис

LPFNVIEWCALLBACK Lpfnviewcallback;

HRESULT Lpfnviewcallback(
  [in] IShellView *psvOuter,
  [in] IShellFolder *psf,
  [in] HWND hwndMain,
       UINT uMsg,
       WPARAM wParam,
       LPARAM lParam
)
{...}

Параметры

[in] psvOuter

Тип: IShellView*

Указатель на экземпляр-владельце IShellView, если применимо. Этот параметр может принимать значение NULL.

[in] psf

Тип: IShellFolder*

Указатель на экземпляр IShellFolder, к которому относится сообщение.

[in] hwndMain

Тип: HWND

Дескриптор окна, содержащего представление, получающее сообщение.

uMsg

Тип: UINT

Одно из следующих уведомлений.

SFVM_ADDPROPERTYPAGES

Позволяет объекту обратного вызова предоставить страницу для добавления в страницу свойств Свойства выбранного объекта.

SFVM_BACKGROUNDENUM

Позволяет объекту обратного вызова запрашивать выполнение перечисления в фоновом потоке.

SFVM_BACKGROUNDENUMDONE

Уведомляет объект обратного вызова о завершении фонового перечисления.

SFVM_COLUMNCLICK

Уведомляет объект обратного вызова о том, что пользователь щелкнул заголовок столбца для сортировки списка объектов в представлении папок.

SFVM_DEFITEMCOUNT

Позволяет объекту обратного вызова указать количество элементов в представлении папок.

SFVM_DEFVIEWMODE

Позволяет объекту обратного вызова указать режим просмотра.

SFVM_DIDDRAGDROP

Уведомляет функцию обратного вызова о начале операции перетаскивания.

SFVM_FSNOTIFY

Уведомляет объект обратного вызова о том, что произошло событие, влияющее на один из его элементов.

SFVM_GETANIMATION

Позволяет объекту обратного вызова указать, что анимация будет отображаться при перечислении элементов в фоновом потоке.

SFVM_GETBUTTONINFO

Позволяет объекту обратного вызова добавлять кнопки на панель инструментов.

SFVM_GETBUTTONS

Позволяет объекту обратного вызова указать кнопки для добавления на панель инструментов.

SFVM_GETDETAILSOF

Позволяет объекту обратного вызова предоставлять сведения об элементе в папке оболочки. Используйте только в том случае, если вызов IShellFolder2::GetDetailsOf завершается сбоем и нет метода IShellDetails::GetDetailsOf , доступного для вызова.

SFVM_GETHELPTEXT

Позволяет объекту обратного вызова указать текстовую строку справки для пунктов меню или кнопок панели инструментов.

SFVM_GETHELPTOPIC

Позволяет объекту обратного вызова указать файл справки и раздел.

SFVM_GETNOTIFY

Указывает, какие события будут создавать SFVM_FSNOTIFY сообщение для данного элемента.

SFVM_GETPANE

Позволяет объекту обратного вызова предоставлять панель строки состояния, в которой будут отображаться сведения о зоне Интернета.

SFVM_GETSORTDEFAULTS

Позволяет объекту обратного вызова указывать параметры сортировки по умолчанию.

SFVM_GETTOOLTIPTEXT

Позволяет объекту обратного вызова указать текстовую строку подсказки для пунктов меню или кнопок панели инструментов.

SFVM_GETZONE

Позволяет объекту обратного вызова предоставлять сведения о зоне Интернета.

SFVM_INITMENUPOPUP

Позволяет объекту обратного вызова изменять контекстное меню элемента.

SFVM_INVOKECOMMAND

Уведомляет объект обратного вызова о том, что была вызвана одна из команд панели инструментов или меню.

SFVM_MERGEMENU

Позволяет объекту обратного вызова объединять элементы меню в меню Windows Обозреватель.

SFVM_QUERYFSNOTIFY

Позволяет объекту обратного вызова зарегистрировать папку, чтобы изменения в представлении этой папки создавали уведомления.

SFVM_SETISFV

Уведомляет объект обратного вызова сайта контейнера. Используется только в том случае , если IObjectWithSite::SetSite не поддерживается и используется SHCreateShellFolderViewEx .

SFVM_SIZE

Уведомляет объект обратного вызова о том, что размер представления папки изменен.

SFVM_THISIDLIST

Позволяет объекту обратного вызова указать PIDL представления. Используется только в случае сбоя IPersistIDList::SetIDList и IPersistFolder2::GetCurFolder .

SFVM_UNMERGEMENU

Уведомляет объект обратного вызова о том, что меню удаляется.

SFVM_UPDATESTATUSBAR

Позволяет объекту обратного вызова запрашивать обновление строки состояния.

SFVM_WINDOWCREATED

Уведомляет объект обратного вызова о создании окна представления папки.

wParam

Тип: WPARAM

Дополнительные сведения, зависящие от значения в uMsg. Дополнительные сведения см. на отдельных страницах уведомлений.

lParam

Тип: LPARAM

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

Тип: HRESULT

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)

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

IShellFolderViewCB

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