Class Hierarchy
IDynamicPropertyNotify
C++
class IDynamicPropertyNotify : public IUnknown;
File
dynprops.h
Description
When a dynamic property changes, the Properties window needs to be notified so that it knows to refresh the values of the properties it is displaying. The standard mechanism of IConnectionPoint/IConnectionPointContainer is too general and inefficient for the simple bi-directional mechanism needed here. All that is required is for the server (the Properties window component) to pass a sink interface to the property class implementer, who then hangs on to that interface pointer, and uses it to inform the Properties window when to re-get the property values. To this end, IDynamicProperty includes two methods, Connect()and Disconnect(), that the developer should implement and the Properties window code will call, passing the sink interface, IDynamicPropertyNotify. The Properties window code calls Connect() passing the IDynamicPropertyNotify pointer, which the property class implementer should hold onto until the Properties window code calls Disconnect(), at which point it should be released. While connected, if a property change occurs, either externally or because another property was set that effects the current property value, the developer should call IDyanamicPropertyNotify::OnChanged() to notify the Properties window to refresh the property list.
Links
See Also
IDynamicProperty