Freigeben über

Gewusst wie: Erstellen Sie ein Toolbox-Steuerelement, die Windows Forms verwendet

  • Artikel

Die Windows Form-Toolbox-Steuerelementvorlage, die in Visual Studio 2010 SDK enthalten ist, können Sie Windows Forms-Steuerelemente erstellen, die automatisch mitToolboxhinzugefügt werden, wenn die Erweiterung installiert ist. In diesem Thema wird gezeigt, wie die Vorlage zum Anzeigen eines Toolbox-Steuerelement zu erstellen, das Sie an andere Benutzer verteilen können. Eine vollständige Implementierung eines Toolbox Steuerelements finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Windows Form-Toolbox-Steuerelement.

Hinweis

Weitere Informationen über das Visual Studio-SDK finden Sie unter Erweitern von Visual Studio Overview.Um herauszufinden finden Sie unter wie das Visual Studio-SDK, auf Visual Studio Extensibility Developer Center der MSDN-Website herunterlädt.

Ein Toolbox-Steuerelement erstellen

Verwenden Sie die Windows Form-Toolbox-Steuerelementvorlage, um das Projekt zu erstellen, und erstellen Sie dann eine Benutzeroberfläche im Designer.

So erstellen Sie ein Windows Form-Toolbox-Steuerelementprojekt

  1. Klicken Sie im Menü Datei auf Neu und dann auf Projekt.

  2. Im Dialogfeld Neues Projekt unter Installierte Vorlagen, klicken Sie auf den Knoten für Ihre bevorzugte Programmiersprache, und klicken Sie dann auf Erweiterungen. Klicken Sie in der Liste der Projekttypen die Option Windows Forms-Toolbox-Steuerelement.

  3. Geben Sie im Feld Name Geben Sie den Namen ein, den Sie für das Projekt verwenden möchten. Klicken Sie auf OK.

    Visual Studio erstellt eine Projektmappe, die ein Benutzersteuerelement ein Attribut enthält, um das Steuerelement in Toolboxeinzufügen und ein VSIX-Manifest für die Bereitstellung.

Um das Steuerelement Benutzeroberfläche erstellen

  1. In Projektmappen-ExplorerDoppelklick ToolboxControl.cs, um sie im Designer zu öffnen.

  2. Ziehen Sie aus Toolboxalle Steuerelemente, die Sie auf die Entwurfsoberfläche, und ordnen Sie sie entsprechend dem Entwurf veranschaulicht.

  3. Legen Sie im Fenster Eigenschaften öffentliche Eigenschaften für das Benutzersteuerelement und den untergeordneten Steuerelementen auf fest.

Das Steuerelement Codieren

Standardmäßig wird das Steuerelement in Toolbox als ToolboxControl1 in einer Gruppe Toolboxelement, die den gleichen Namen wie die Lösung verfügt. Sie können diese Namen in der ToolboxControl.cs-Datei ändern.

Wenn das Steuerelement Code

  1. In Projektmappen-Explorermit der rechten Maustaste auf ToolboxControl.cs, und klicken Sie dann auf Code anzeigen , um die Datei in der Codeansicht zu öffnen.

  2. Bei der Definition der partiellen Klasse, die das Steuerelement implementiert, klicken mit der rechten Maustaste auf den Klassennamen, klicken Sie auf Umgestalten, und klicken Sie dann auf Umbenennen. Ändern Sie den Namen der Klasse in den Namen, den Sie in Toolbox angezeigt werden soll, wenn das Steuerelement installiert ist.

  3. Fügen Sie direkt oberhalb der Klassendefinition in der ProvideToolboxControl-Attributdeklaration, Änderung der Wert des ersten Parameters dem Namen der Elementgruppe, die das Steuerelement in Toolboxwird.

    Im folgenden Beispiel wird das ProvideToolboxControl-Attribut und die angepasste Klassendefinition für ein Steuerelement veranschaulicht, das Indikator in der Allgemein-Elementgruppe benannt ist.

    [ProvideToolboxControl("General", false)]
public partial class Counter : UserControl

  4. Implementieren Sie die Eigenschaften, Methoden und Ereignisse für das Steuerelement.

Builds, Tests und Bereitstellung

Drücken Sie F5, erstellt das Projekt mit einer VSIX-Bereitstellungsdatei enthält, und öffnet eine zweite Instanz von Visual Studio, das das Steuerelement enthält, das in Toolboxinstalliert ist.

Um das Steuerelement erstellen und testen

  1. Drücken Sie F5.

  2. In der neuen Instanz von Visual Studio, erstellen Sie ein Windows Forms-Anwendungsprojekt.

  3. Suchen Sie das Steuerelement in Toolbox und ziehen Sie es auf die Entwurfsoberfläche.

  4. Klicken Sie im Fenster Eigenschaften Sie sicher, dass die Eigenschaften wie erwartet angezeigt werden.

  5. Fügen Sie allen Code oder zusätzlichen Steuerelemente hinzu, die erforderlich sind, um die Methoden und Ereignisse zu testen.

  6. Drücken Sie F5, um die Windows Forms-Anwendung zu öffnen.

  7. Stellen Sie sicher, dass die Eigenschaften, Methoden und Ereignisse des Steuerelements sich erwartungsgemäß verhalten.

Um das Steuerelement bereitstellen

  1. Nachdem Sie das getestete Projekts öffnen Sie " \ bin \ Debug \ des Projekts in Windows Explorer, und suchen Sie die VSIX-Datei.

  2. Laden Sie die VSIX-Datei in einem Netzwerk oder auf einer Website hoch.

    Wenn Sie die Datei zur Visual Studio Gallery Website hochladen, können andere Benutzer Erweiterungs-Manager in Visual Studio verwenden, um das Steuerelement zu suchen und sie zu installieren.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Erstellen eines Windows Form-Toolbox-Steuerelement

Gewusst wie: Erstellen Sie ein Toolbox-Steuerelement, die WPF verwendet

Weitere Ressourcen

Toolbox (Visual Studio SDK)