IAdviseSinkEx

The IAdviseSinkEx interface is derived from IAdviseSink to provide extensions for notifying the sink of changes in an object’s view status.

When to Implement

Container applications and compound documents implement a site object with the IAdviseSinkEx interface to receive notification of changes in the view status of a contained object.

When to Use

A contained object, such as a control, calls the method of IAdviseSinkEx to notify its container of changes in its view status.

To determine which interface the sink supports, an object must call QueryInterface using the pointer that was passed to IViewObject::SetAdvise.

Methods in Vtable Order

IUnknown Methods	Description
QueryInterface	Returns pointers to supported interfaces.
AddRef	Increments reference count.
Release	Decrements reference count.

IAdviseSink Methods	Description
OnDataChange	Advises that data has changed.
OnViewChange	Advises that view of object has changed.
OnRename	Advises that name of object has changed.
OnSave	Advises that object has been saved to disk.
OnClose	Advises that object has been closed.

IAdviseSinkEx Methods	Description
OnViewStatusChange	Notifies the sink that a view status of an object has changed.

See Also

IAdviseSink, IViewObject::SetAdvise