Export (0) Print
Expand All

IAdviseSink::OnViewChange method

Notifies an object's registered advise sinks that its view has changed.

Syntax


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

Parameters

dwAspect [in]

The aspect, or view, of the object. Contains a value taken from the DVASPECT enumeration.

lindex [in]

The portion of the view that has changed. Currently only -1 is valid.

Return value

This method does not return a value.

Remarks

Containers register to be notified when an object's view changes by calling IViewObject::SetAdvise. After it is registered, the object will call the sink's IAdviseSink::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 may represent only one value. That is, dwAspect cannot contain the result of an OR operation combining two or more DVASPECT values.

The lindex parameter represents the part of the aspect that is of interest. The value of lindex depends on the value of dwAspect. If dwAspect is either 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 currently valid.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IAdviseSink is defined as 00000150-0000-0000-C000-000000000046

See also

IAdviseSink
IViewObject::SetAdvise

 

 

Community Additions

ADD
Show:
© 2014 Microsoft