IComponentInitializer Interface
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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. |