Метод IAdviseSink::OnViewChange (objidl.h)

Статья
08/25/2023

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

Синтаксис

void OnViewChange(
  [in] DWORD dwAspect,
  [in] LONG  lindex
);

Параметры

[in] dwAspect

Аспект, или представление, объекта. Содержит значение, полученное из перечисления DVASPECT .

[in] lindex

Часть представления, которое изменилось. В настоящее время допустимо только значение -1.

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

None

Remarks

Контейнеры регистрируются для уведомления при изменении представления объекта путем вызова IViewObject::SetAdvise. После регистрации объект при необходимости вызовет метод IAdviseSink::OnViewChange приемника. OnViewChange можно вызывать, когда объект находится в загруженном или запущенном состоянии.

Несмотря на то, что значения DVASPECT являются отдельными битами флага, dwAspect может представлять только одно значение. То есть dwAspect не может содержать результат операции OR, объединяющей два или более значения DVASPECT .

Параметр lindex представляет интересующую часть аспекта. Значение lindex зависит от значения dwAspect. Если параметр dwAspect имеет значение DVASPECT_THUMBNAIL или DVASPECT_ICON, lindex игнорируется. Если параметр dwAspect имеет значение DVASPECT_CONTENT, lindex должен иметь значение -1, что означает, что все представление представляет интерес и является единственным допустимым значением в данный момент.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	objidl.h

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

IAdviseSink

IViewObject::SetAdvise