IAdviseSink::OnViewChange

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method advises the sink that an object has been closed.

Syntax

void OnViewChange( 
  DWORD dwAspect, 
  LONG lindex
);

Parameters

  • dwAspect
    [in] Specifies the aspect, or view, of the object.

    Contains a value taken from the enumeration, DVASPECT.

  • lindex
    [in] Portion of the view that has changed.

    Currently only 1 is valid.

Return Value

None.

Remarks

Containers register to be notified when an object's view changes by calling IViewObject::SetAdvise. When registered, the object calls the sink's OnViewChange method when appropriate. OnViewChange can be called when the object is in either the loaded or running state.

Even though DVASPECT values are individual flag bits, dwAspect might represent only one value. That is, dwAspect cannot contain the result of an OR operation combining two or more DVASPECT values.

The lindex member represents the part of the aspect that is of interest. The value of lindex depends on the value of dwAspect.

If dwAspect is DVASPECT_THUMBNAIL or DVASPECT_ICON, lindex is ignored.

If dwAspect is DVASPECT_CONTENT, lindex must be 1, which indicates that the entire view is of interest and is the only value that is valid.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header objidl.h, objidl.idl
Library oleaut32.lib, uuid.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IAdviseSink
DVASPECT
IViewObject::SetAdvise

Concepts

Determining Supported COM APIs