Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten Toolboxsymbols für ein Steuerelement

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

In dieser exemplarischen Vorgehensweise wird veranschaulicht, wie Sie ein Toolboxsymbol für ein benutzerdefiniertes WPF (Windows Presentation Foundation)-Steuerelement erstellen. Wenn Sie das benutzerdefinierte Steuerelement der Toolbox hinzufügen, wird das Symbol neben dem Namen des Steuerelements angezeigt.

Im Verlauf dieser exemplarischen Vorgehensweise führen Sie folgende Aufgaben aus:

• Erstellen eines benutzerdefinierten WPF-Steuerelementbibliothek-Projekts

• Erstellen einer benutzerdefinierten Bitmapdatei für das Toolboxsymbol des Steuerelements.

• Testen Sie das Symbol des Steuerelements zur Entwurfszeit.

Anschließend wissen Sie, wie ein Toolboxsymbol für ein benutzerdefiniertes Steuerelement erstellt wird.

Hinweis

Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen.Wählen Sie im Menü Extras die Option Einstellungen importieren und exportieren aus, um die Einstellungen zu ändern.Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

• Visual Studio 2010.

Erstellen eines benutzerdefinierten Toolboxsymbols

Um ein benutzerdefiniertes Toolboxsymbol für ein Steuerelement zu erstellen, fügen Sie dem Projekt des Steuerelements ein Bild als eingebettete Ressource hinzu.

So erstellen Sie ein benutzerdefiniertes Toolboxsymbol

1. Erstellen Sie ein neues benutzerdefiniertes WPF-Steuerelementbibliothek-Projekt in Visual Basic oder Visual C# mit dem Namen CustomControlWithToolboxIcon.

   Der Code für CustomControl1 wird im Code-Editor geöffnet.

2. Wählen Sie im Menü Projekt die Option Neues Element hinzufügen aus.

   Das Dialogfeld Neues Element hinzufügen wird angezeigt.

3. Wählen Sie im Dialogfeld Neues Element hinzufügen die Kategorie Allgemein aus.

4. Wählen Sie in der Liste der Vorlagen Bitmapdatei aus, nennen Sie die neue Datei CustomControl1.Icon.bmp, und klicken Sie dann auf Hinzufügen.

   Der Grafik-Editor wird geöffnet.

5. Legen Sie im Eigenschaftenfenster die Eigenschaft Farben der Bitmap auf 24 bit fest.

6. Verwenden Sie die Grafik-Editor-Tools, um in der Bitmap ein Bild zu zeichnen. Weitere Informationen finden Sie unter Bild-Editor für Symbole.

7. Wählen Sie im Projektmappen-Explorer CustomControl1.Icon.bmp aus.

8. Legen Sie im Eigenschaftenfenster die Eigenschaft Buildvorgang auf Eingebettete Ressource fest.

9. Erstellen Sie die Projektmappe.

   Weitere Informationen finden Sie unter Toolboxsymbole.

Testen des Toolboxsymbols

Testen Sie das benutzerdefinierte Toolboxsymbol, indem Sie CustomControl1 der Toolbox hinzufügen.

So testen Sie das Toolboxsymbol

1. Fügen Sie der Projektmappe ein neues WPF-Anwendungsprojekt in Visual Basic oder Visual C# mit dem Namen TestApplication hinzu.

   Die Datei "MainWindow.xaml" wird im WPF Designer geöffnet. In der Toolbox wird CustomControl1 auf der Registerkarte CustomControlWithToolboxIcon-Steuerelemente angezeigt.

   

2. Klicken Sie in der Toolbox mit der rechten Maustaste auf CustomControl1, und wählen Sie Löschen aus.

3. Klicken Sie im angezeigten Meldungsfeld auf OK.

   CustomControl1 wird aus der Toolbox entfernt.

4. Klicken Sie in der Toolbox mit der rechten Maustaste auf die Steuerelementgruppe, der Sie das Steuerelement hinzufügen möchten, und wählen Sie dann Elemente auswählen im Kontextmenü aus.

   Das Dialogfeld Toolboxelemente auswählen wird geöffnet.

5. Klicken Sie im Dialogfeld Toolboxelemente auswählen auf die Registerkarte WPF-Komponenten. Weitere Informationen finden Sie unter Wählen Sie die Option WPF-Komponenten, Toolboxelemente.

6. Klicken Sie auf Durchsuchen, und navigieren Sie zum bin\Debug-Ordner des CustomControlWithToolboxIcon-Projekts.

7. Wählen Sie im Dialogfeld Öffnen CustomControlWithToolboxIcon.dll aus, und klicken Sie dann auf Öffnen.

   Details der CustomControlWithToolboxIcon-Assembly werden im Dialogfeld Toolboxelemente auswählen angezeigt. Das benutzerdefinierte Symbol wird im Gruppenfeld CustomControl1 angezeigt.

8. Klicken Sie auf OK.

   CustomControl1 wird in der Toolbox mit dem entsprechenden Symbol angezeigt.

   

Siehe auch

Aufgaben

Gewusst wie: Einbetten eines Symbols in eine Assembly

Exemplarische Vorgehensweise: Bereitstellen von Metadaten für Toolboxsymbole

Konzepte

Toolboxsymbole

Weitere Ressourcen

Wählen Sie die Option WPF-Komponenten, Toolboxelemente

Verwenden von Ressourcen