Export (0) Print
Expand All

IPropertyNotifySink interface

Implemented by a sink object to receive notifications about property changes from an object that supports IPropertyNotifySink as an outgoing interface. The client that needs to receive the notifications in this interface (from a supporting connectable object) creates a sink with this interface and connects it to the connectable object through the connection point mechanism. For more information on connection points, see IConnectionPointContainer.

When to implement

Implement this interface for a sink object that receives notifications about property changes from an object that supports this kind of notification.

When to use

Use this interface to notify a sink object about changes in a property.

Members

The IPropertyNotifySink interface inherits from the IUnknown interface. IPropertyNotifySink also has these types of members:

Methods

The IPropertyNotifySink interface has these methods.

MethodDescription
OnChanged

Notifies a sink that a bindable property has changed.

OnRequestEdit

Notifies a sink that a requestedit property is about to change.

 

Remarks

The object is itself required to call the methods of IPropertyNotifySink only for those properties marked with the [bindable] and [requestedit] attributes in the object's type information. When the object changes a [bindable] property, it is required to call IPropertyNotifySink::OnChanged. When the object is about to change a [requestedit] property, it must call IPropertyNotifySink::OnRequestEdit before changing the property and must also honor the action specified by the sink on return from this call.

The one exception to this rule is that no notifications are sent as a result of an object's initialization or loading procedures. At initialization time, it is assumed that all properties change and that all must be allowed to change. Notifications to this interface are therefore meaningful only in the context of a fully initialized/loaded object.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

OCIdl.h

IDL

OCIdl.idl

IID

IID_IPropertyNotifySink is defined as 9BFBBC02-EFF1-101A-84ED-00AA00341D07

See also

IConnectionPoint
IConnectionPointContainer

 

 

Community Additions

ADD
Show:
© 2014 Microsoft