Microsoft KB Archive/813808

= INFO: Code Sample That Demonstrates How to Create a Custom Form Designer by Using Visual C# .NET =

Article ID: 813808

Article Last Modified on 5/24/2007

-

APPLIES TO


 * Microsoft .NET Framework 1.1
 * Microsoft .NET Framework 1.0
 * Microsoft Visual C# .NET 2003 Standard Edition
 * Microsoft Visual C# .NET 2002 Standard Edition

-





SUMMARY
This article contains a code sample that demonstrates how to create a custom form designer by using Microsoft Visual C# .NET. Microsoft does not provide Microsoft Product Support Services or support hotfixes for this code sample.



MORE INFORMATION
To create a custom form designer, you must implement and use multiple interfaces. The sample code that this article contains illustrates the concepts that are involved in creating a custom form designer. The following are the two most important interfaces that you must implement:
 * IDesignerHost: This is defined in the System.ComponentModel.Design namespace.
 * IContainer: This is defined in the System.ComponentModel namespace.

Implement the IDesignerHost interface to provide support for designer transaction, for component management, and for retrieved designers.

When you implement the IContainer.Add method, see if the component that you are adding is the first component. If the component is the first component on your custom form designer, retrieve the corresponding IRootDesigner interface. If the component is not the first component on your custom form designer, retrieve the corresponding IDesigner interface. After you retrieve the appropriate interface (IDesigner or IRootDesigner), associate the retrieved designer with your custom form designer to provide the basic framework for your custom form designer. Then display your custom form designer. For more information, see the code sample and the associated documentation. Microsoft does not provide any support for the code sample.

The following file is available for download from the Microsoft Download Center:

Download the DesignerHost.exe package now. For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to Obtain Microsoft Support Files from Online Services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file. To use this sample code, build, and then run DesignerHost.

