Sdílet prostřednictvím

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

  • Článek

Aktualisiert: November 2007

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 des Steuerelements zur Entwurfszeit.

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

Cc165606.alert_note(de-de,VS.90).gifHinweis:

Je nach den aktiven Einstellungen oder der verwendeten Version können die angezeigten Dialogfelder und Menübefehle von den in der Hilfe beschriebenen abweichen. Sie können die Einstellungen ändern, indem Sie im Menü Extras auf Einstellungen importieren und exportieren klicken. Weitere Informationen hierzu finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

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

  • Visual Studio 2008.

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 im Bereich VorlagenBitmapdatei aus, nennen Sie die neue Datei CustomControl1.Icon.bmp, und klicken Sie 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 hierzu finden Sie unter Grafik-Editor.

  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 hierzu finden Sie unter Toolboxsymbole und eingebettete Ressourcen.

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 Window1.xaml wird in WPF-Designer geöffnet.

  2. Fügen Sie einen Verweis auf das Projekt CustomControlWithToolboxIcon hinzu.

  3. Klicken Sie in der Toolbox mit der rechten Maustaste, und wählen Sie Elemente auswählen aus dem Kontextmenü.

    Das Dialogfeld Toolboxelemente auswählen wird geöffnet.

  4. Klicken Sie im Dialogfeld Toolboxelemente auswählen auf die Registerkarte WPF-Komponenten. Weitere Informationen hierzu finden Sie unter Registerkarte "WPF-Komponenten", Dialogfeld "Toolboxelemente auswählen".

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

  6. Doppelklicken Sie auf CustomControlWithToolboxIcon.dll, um die Datei auszuwählen.

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

  7. 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

Konzepte

Toolboxsymbole und eingebettete Ressourcen

Weitere Ressourcen

Grundlagen zu Erweiterungen