System 2.0.0.0 4.0.0.0

The interface can be implemented by any designer, which is a component that also implements , which receives a recommended set of default values for the component it is designing. is queried during new component creation. Recommended default values for the component's properties are passed in as name/value pairs in a dictionary.

This design provides two customization points: the toolbox item itself can be replaced or changed to perform custom actions, or the designer for a component can be changed to provide a custom action. A designer that implements should not depend on either of its methods— or —being called, because toolbox items are not obligated to call these methods.

For an overview of creating design components, see Extending Design-Time Support.

Provides a set of recommended default values during component creation.

- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  The method is called when a designer will re-initialize an existing component. For example, is commonly called after a drag-and-drop operation. The parameter is a dictionary containing name/value pairs of default values that should be applied to properties of the associated component. This dictionary may be null if no default values have been specified.

  When implementing this method, generally you should not modify the component properties beyond those recommendations found in . The existing component may already have had its properties set by the user or other design-time code.

  Restores an instance of a component to its default state.

  A dictionary of default property values, which are name/value pairs, with which to reset the component's state.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  The method is called after a new component is created. It is typically called by the toolbox item itself and is used to configure the component’s default values.

  This dictionary may be null if no default values are specified. If the dictionary is null, the component properties should be left in their implicit default states.

  Initializes a new component using a set of recommended values.

  A dictionary of default property values, which are name/value pairs, with which to initialize the component's state.