Exemplarische Vorgehensweise: Automatisches Füllen der Toolbox mit benutzerdefinierten Komponenten

Wenn die Komponenten durch ein Projekt in der momentan geöffneten Projektmappe definiert sind, werden sie automatisch in der Toolbox angezeigt, ohne dass hierfür eine Aktion erforderlich ist. Sie können die Toolbox auch manuell mit den benutzerdefinierten Komponenten füllen, indem Sie das Dialogfeld "Toolboxelemente auswählen" (Visual Studio) verwenden. Die Toolbox berücksichtigt allerdings Elemente in den Buildausgaben der Projektmappe, einschließlich folgender Merkmale:

• Implementiert IComponent;

• Hat ToolboxItemAttribute nicht auf false festgelegt;

• Hat DesignTimeVisibleAttribute nicht auf false festgelegt.

Diese exemplarische Vorgehensweise veranschaulicht, wie eine benutzerdefinierte Komponente automatisch in der Toolbox angezeigt wird, sobald die Komponente erstellt wird. Zu den Aufgaben in dieser exemplarischen Vorgehensweise gehören:

• Erstellen eines Windows Forms-Projekts

• Erstellen einer benutzerdefinierten Komponente

• Erstellen einer Instanz einer benutzerdefinierten Komponente

• Entladen und erneutes Laden einer benutzerdefinierten Komponente

Anschließend werden Sie sehen, dass die Toolbox mit einer von Ihnen erstellten Komponente gefüllt ist.

Erstellen des Projekts

Zunächst wird das Projekt erstellt und das Formular eingerichtet.

So erstellen Sie das Projekt

1. Erstellen Sie ein Windows-basiertes Anwendungsprojekt mit dem Namen ToolboxExample.

   Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines neuen Windows Forms-Anwendungsprojekts.

2. Fügen Sie dem Projekt eine neue Komponente hinzu. Nennen Sie sie DemoComponent.

   Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen neuer Projektelemente.

3. Erstellen Sie das Projekt.

4. Klicken Sie im Menü Extras auf das Element Optionen. Klicken Sie unter dem Element Windows Forms-Designer auf Allgemein, und vergewissern Sie sich, dass die AutoToolboxPopulate-Option auf True festgelegt ist.

Erstellen einer Instanz einer benutzerdefinierten Komponente

Der nächste Schritt besteht darin, auf dem Formular eine Instanz der benutzerdefinierten Komponente zu erstellen. Da die neue Komponente in der Toolbox automatisch berücksichtigt wird, ist dieser Schritt ebenso einfach wie das Erstellen einer anderen Komponente oder eines Steuerelements.

So erstellen Sie eine Instanz einer benutzerdefinierten Komponente

1. Öffnen Sie das Formular des Projekts im Windows Forms-Designer.

2. Klicken Sie in der Toolbox auf die neue Registerkarte ToolboxExample-Komponenten.

   Sobald Sie auf die Registerkarte klicken, sehen Sie DemoComponent.

   Tipp

   Aus Leistungsgründen zeigen Komponenten im automatisch gefüllten Bereich der Toolbox keine benutzerdefinierten Bitmaps an, und das ToolboxBitmapAttribute wird nicht unterstützt. Um in der Toolbox ein Symbol für eine benutzerdefinierte Komponente anzuzeigen, laden Sie die Komponente mithilfe des Dialogfelds Toolboxelemente auswählen.

3. Ziehen Sie die Komponente auf das Formular.

   Eine Instanz der Komponente wird erstellt und der Komponentenleiste hinzugefügt.

Entladen und erneutes Laden einer benutzerdefinierten Komponente

Die Toolbox berücksichtigt die Komponenten in jedem geladenen Projekt. Wenn ein Projekt entladen wird, entfernt sie Verweise auf die Projektkomponenten.

So testen Sie die Auswirkung des Entladens und erneuten Ladens von Komponenten auf die Toolbox

1. Entladen Sie das Projekt aus der Projektmappe.

   Weitere Informationen über das Entladen von Projekten finden Sie unter Gewusst wie: Entladen und erneutes Laden von Projekten. Wenn Sie aufgefordert werden zu speichern, wählen Sie Ja aus.

2. Fügen Sie der Projektmappe ein neues Projekt vom Typ Windows-Anwendung hinzu. Öffnen Sie das Formular im Designer.

   Die Registerkarte ToolboxExample-Komponenten aus dem vorherigen Projekt ist nicht mehr verfügbar.

3. Laden Sie das ToolboxExample-Projekt erneut.

   Die Registerkarte ToolboxExample-Komponenten wird wieder angezeigt.

Nächste Schritte

Diese exemplarische Vorgehensweise veranschaulicht, dass die Toolbox nicht nur die Komponenten eines Projekts berücksichtigt, sondern auch die Steuerelemente. Experimentieren Sie mit den benutzerdefinierten Steuerelementen, indem Sie Steuerelementprojekte der Projektmappe hinzufügen und daraus entfernen.

Siehe auch

Aufgaben

Gewusst wie: Ändern von Registerkarten der Toolbox

Referenz

Allgemein, Windows Forms-Designer, Dialogfeld "Optionen"

Dialogfeld "Toolboxelemente auswählen" (Visual Studio)

Weitere Ressourcen

Einfügen von Steuerelementen in Windows Forms