Edit

Share via


IComponentInitializer Interface

Definition

Provides a set of recommended default values during component creation.

public interface class IComponentInitializer
public interface IComponentInitializer
type IComponentInitializer = interface
Public Interface IComponentInitializer
Derived

Remarks

The IComponentInitializer interface can be implemented by any designer, which is a component that also implements IDesigner, which receives a recommended set of default values for the component it is designing. IComponentInitializer 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 IComponentInitializer should not depend on either of its methods - InitializeNewComponent or InitializeExistingComponent - being called, because toolbox items are not obligated to call these methods.

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

Methods

InitializeExistingComponent(IDictionary)

Restores an instance of a component to its default state.

InitializeNewComponent(IDictionary)

Initializes a new component using a set of recommended values.

Applies to

See also