Provides an interface to manage the images, ToolTips, and event handlers for the properties of a component displayed in a property browser.

See Also: IPropertyValueUIService Members


public interface IPropertyValueUIService


A component can use the System.Drawing.Design.IPropertyValueUIService interface to provide System.Drawing.Design.PropertyValueUIItem objects for any properties of the component. A System.Drawing.Design.PropertyValueUIItem associated with a property can provide an image, a ToolTip and an event handler for the event that is raised when the image associated with the property is clicked.

The System.Drawing.Design.IPropertyValueUIService interface provides methods to add, remove, and retrieve System.Drawing.Design.PropertyValueUIHandler delegates to or from an internal list. When the properties of a component are displayed in a property browser, each System.Drawing.Design.PropertyValueUIHandler in the list is given an opportunity to provide a System.Drawing.Design.PropertyValueUIItem for each property of the component.

When a property browser is set to display the properties of an object, it calls the IPropertyValueUIService.GetPropertyUIValueItems(System.ComponentModel.ITypeDescriptorContext, System.ComponentModel.PropertyDescriptor) method of this interface for each property of the component, passing a System.ComponentModel.PropertyDescriptor that represents the property. The IPropertyValueUIService.GetPropertyUIValueItems(System.ComponentModel.ITypeDescriptorContext, System.ComponentModel.PropertyDescriptor) method calls each System.Drawing.Design.PropertyValueUIHandler that has been added to the service. Each System.Drawing.Design.PropertyValueUIHandler can add a System.Drawing.Design.PropertyValueUIItem to the ArrayList parameter passed in the valueUIItemList parameter to supply UI items for the property represented by the System.ComponentModel.PropertyDescriptor passed in the propDesc parameter.

A System.Drawing.Design.PropertyValueUIItem can contain an image to display next to the property name, a ToolTip string, and an event handler to invoke when an image associated with the property is double-clicked.


Namespace: System.Drawing.Design
Assembly: System.Drawing (in System.Drawing.dll)
Assembly Versions: 1.0.3300.0, 1.0.5000.0,