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

  • Artikel

Wenn Ihre Komponenten durch ein Projekt in der aktuell geöffneten Projektmappe definiert sind, werden sie automatisch in der Toolbox angezeigt, ohne dass Sie dazu aktiv werden müssen. Sie können die Toolbox auch manuell mit Ihren benutzerdefinierten Komponenten auffüllen, indem Sie das Dialogfeld Toolboxelemente auswählen (Visual Studio) verwenden, aber die Toolbox berücksichtigt alle Elemente in den Buildausgaben Ihrer Lösung, die die folgenden Merkmale aufweisen:

Hinweis

Die Toolbox folgt keinen Verweisketten, d. h. sie zeigt keine Elemente an, die nicht durch ein Projekt in Ihrer Projektmappe erstellt wurden.

In dieser exemplarischen Vorgehensweise wird veranschaulicht, wie eine benutzerdefinierte Komponente automatisch in der Toolbox angezeigt wird, sobald die Komponente erstellt wurde. In dieser exemplarischen Vorgehensweise werden u. a. folgende Aufgaben veranschaulicht:

  • Erstellen eines Windows Forms-Projekts.

  • Erstellen einer benutzerdefinierten Komponente

  • Erstellen einer Instanz einer benutzerdefinierten Komponente

  • Entladen und erneutes Laden einer benutzerdefinierten Komponente

Nach Abschluss der Bearbeitung werden Sie feststellen, dass die Toolbox mit einer Komponente aufgefüllt wurde, die Sie erstellt haben.

Erstellen des Projekts

  1. Erstellen Sie in Visual Studio ein Windows-basiertes Anwendungsprojekt mit dem Namen ToolboxExample (Datei>Neu>Projekt>Visual C# oder Visual Basic>Klassischer Desktop>Windows Forms-Anwendung).

  2. Fügen Sie dem Projekt eine neue Komponente hinzu. Geben Sie ihm den Namen DemoComponent.

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

  3. Erstellen Sie das Projekt.

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

Erstellen einer Instanz einer benutzerdefinierten Komponente

Der nächste Schritt besteht darin, eine Instanz der benutzerdefinierten Komponente im Formular zu erstellen. Da die Toolbox die neue Komponente automatisch berücksichtigt, ist dies so einfach wie das Erstellen einer weiteren Komponente oder eines weiteren Steuerelements.

  1. Öffnen Sie das Projektformular im Forms-Designer.

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

    Sobald Sie auf die Registerkarte klicken, wird DemoComponent angezeigt.

    Hinweis

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

  3. Ziehen Sie Ihre Komponente auf Ihr Formular.

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

Entladen und Laden einer benutzerdefinierten Komponente

Die Toolbox berücksichtigt die Komponenten in jedem geladenen Projekt, und wenn ein Projekt entladen wird, entfernt die Toolbox die Verweise auf die Komponenten des Projekts.

  1. Entladen Sie das Projekt aus der Projektmappe.

    Weitere Informationen zum Entladen von Projekten finden Sie unter Vorgehensweise: Entladen und erneutes Laden von Projekten. Wählen Sie Ja aus, wenn Sie zum Speichern aufgefordert werden.

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

    Die Registerkarte ToolboxExample-Komponenten aus dem vorherigen Projekt ist jetzt nicht mehr vorhanden.

  3. Laden Sie das Projekt ToolboxExample neu.

    Die Registerkarte ToolboxExample-Komponenten wird jetzt wieder angezeigt.

Nächste Schritte

In dieser exemplarischen Vorgehensweise wurde veranschaulicht, dass die Toolbox die Komponenten eines Projekts. Die Toolbox berücksichtig aber auch Steuerelemente. Experimentieren Sie mit Ihren eigenen benutzerdefinierten Steuerelementen, indem Sie Steuerelementprojekte zu Ihrer Projektmappe hinzufügen und daraus entfernen.

Weitere Informationen