Freigeben über

Exemplarische Vorgehensweise: Erstellen von Benutzersteuerelementen für Geräte

  • Artikel

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise erstellen Sie eine Steuerelementbibliothek sowie ein Benutzersteuerelement, das Sie der Bibliothek hinzufügen. Sie unterscheiden ein Benutzersteuerelement, bei dem es sich um eine Kombination von Windows Forms-Steuerelementen in einer einzigen wiederverwendbaren Einheit handelt, von einem benutzerdefinierten Steuerelement, für das eine Benutzeroberfläche oder Funktionalität erforderlich ist, die über Standardsteuerelemente nicht verfügbar ist.

Bei dem Benutzersteuerelement in dieser exemplarischen Vorgehensweise handelt es sich um eine einfache Uhranzeige für Geräte, die ähnlichen exemplarischen Vorgehensweisen für den Desktop nachempfunden wurde, z. B. Exemplarische Vorgehensweise: Erstellen eines zusammengesetzten Steuerelements mit Visual Basic und Exemplarische Vorgehensweise: Erstellen eines zusammengesetzten Steuerelements mit Visual C#.

Die exemplarische Vorgehensweise umfasst vier Hauptaufgaben:

  • Erstellen einer Steuerelementbibliothek und eines Steuerelements.

  • Umbenennen der Bibliothek und des Steuerelements.

  • Hinzufügen von Komponenten zum Steuerelement.

  • Testen des Steuerelements mit dem Geräteemulator.

Sie können entweder Visual Basic oder Visual C# für diese exemplarische Vorgehensweise verwenden. Wenn in beiden Sprachen der gleiche Dateiname, allerdings mit einer sprachspezifischen Erweiterung angegeben werden muss, erinnert Sie ein senkrechter Strich daran, die für die von Ihnen verwendete Sprache geeignete Erweiterung auszuwählen, z. B. filename.vb|cs.

Hinweis:

Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Diese exemplarische Vorgehensweise wurde mit Visual Basic-Entwicklungseinstellungen und Visual C#-Entwicklungseinstellungen geschrieben.

Vorbereitungsmaßnahmen

Keine.

Auswählen eines Zielgeräts

Um sicherzustellen, dass Sie beim Bereitstellen der Projektmappe eine Eingabeaufforderung für ein Zielgerät erhalten, führen Sie die folgenden Schritte durch.

So legen Sie fest, dass zum Bereitstellungszeitpunkt ein Gerät ausgewählt werden kann

  1. Klicken Sie im Menü Extras auf Optionen, erweitern Sie Gerätetools, und klicken Sie dann auf Allgemein.

    (Wenn Gerätetools nicht sichtbar ist, wählen Sie unten im Dialogfeld Optionen die Option Alle Einstellungen anzeigen aus.)

  2. Aktivieren Sie das Kontrollkästchen Vor Bereitstellung von Geräteprojekten Geräteauswahl anzeigen.

Erstellen des Projekts

Durch den Namen, den Sie für ein neues Projekt angeben, werden auch die Namen von Stammnamespace und Assembly festlegt.

So erstellen Sie die Steuerelementbibliothek und das Steuerelement

  1. (Visual Basic) Klicken Sie im Menü Datei auf Neues Projekt.

    – oder –

    (Visual C#) Zeigen Sie im Menü Datei auf Neu, und klicken Sie auf Projekt.

  2. Erweitern Sie im Dialogfeld Neues Projekt im Bereich Projekttypen den Typ Visual Basic oder Visual C#, und klicken Sie dann auf Intelligentes Gerät.

    Wenn die gewünschte Sprache nicht sofort angezeigt wird, erweitern Sie den Knoten Weitere Sprachen. Diese Anzeige hängt von den Entwicklungseinstellungen ab.

  3. Klicken Sie im Bereich Vorlagen auf Projekt für intelligente Geräte.

  4. Geben Sie in das Feld Name den Namen ctlDevClockLib ein, und klicken Sie dann auf OK.

  5. (Nur Visual C#) Geben Sie im Feld Speicherort an, wo die Projektdateien gespeichert werden sollen, und klicken Sie dann auf OK.

  6. Wählen Sie im Dropdownmenü Zielplattform die Option Pocket PC 2003 aus.

  7. Wählen Sie aus dem Dropdownmenü .NET Compact Framework-Version die Option .NET Compact Framework Version 2.0 aus.

  8. Klicken Sie im Bereich Vorlagen auf Steuerelementbibliothek und dann auf OK.

    Der Komponenten-Designer wird angezeigt.

Sie haben bereits den Projektnamen, den Stammnamespace und den Assemblynamen (ctlDevClockLib) angegeben. Komponenten im Projekt verfügen jedoch über Standardnamen, die von Visual Studio zugewiesen wurden (z. B. UserControl1). Sie sollten diese Namen i. d. R. in sinnvollere Begriffe ändern.

So benennen Sie die Bibliothek und das Steuerelement um

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf UserControl1.vb|cs und dann auf Eigenschaften.

  2. Ändern Sie den Dateinamen in ctlDevClock.vb|cs.

  3. (Nur Visual C#) Klicken Sie in dem Meldungsfeld, in dem Sie gefragt werden, ob alle Verweise auf dieses Codeelement umbenannt werden sollen, auf Ja.

    Die Namensänderung im Eigenschaftenfenster wird nun an andere Verweise weitergegeben, z. B. den Klassennamen und den Konstruktor.

Danach fügen Sie Komponenten aus der Toolbox hinzu, um Funktionalität und Benutzerinteraktion für das Benutzersteuerelement bereitzustellen. In dieser exemplarischen Vorgehensweise fügen Sie ein Timer-Steuerelement hinzu, um auf die Systemzeit zuzugreifen, und ein Label-Steuerelement, um die Uhrzeit anzuzeigen.

So fügen Sie Komponenten hinzu und ändern ihre Eigenschaften

  1. Doppelklicken Sie in der Toolbox auf Label.

    Im Komponenten-Designer wird dem Benutzersteuerelement ein Label-Steuerelement hinzugefügt.

  2. Führen Sie im Eigenschaftenfenster für das Label-Steuerelement Folgendes aus:

Eigenschaft

Ändern in

Name

lblDisplay

Text

(leer)

TextAlign

TopCenter

Font.Size

14

  1. Doppelklicken Sie in der Toolbox auf Timer.

    Im Komponentenfach wird ein Timer-Steuerelement angezeigt.

  2. Führen Sie im Eigenschaftenfenster für das Timer-Steuerelement Folgendes aus:

Eigenschaft

Ändern in

Interval

1000

Enabled

True

In den nächsten Schritten fügen Sie einen Ereignishandler hinzu, um im Label-Steuerelement Zeiteinheiten anzuzeigen.

So fügen Sie einen Ereignishandler hinzu

  1. Doppelklicken Sie im Komponentenfach auf Timer1 (Visual Basic) oder timer1 (C#), um den Code-Editor beim Tick-Ereignis zu öffnen.

  2. (Visual Basic) Fügen Sie diesen Ereignishandlercode ein:

    lblDisplay.Text = Format(Now, "hh:mm:ss")

    – oder –

    (Visual C#)

    lblDisplay.Text = DateTime.Now.ToLongTimeString();

  3. (Visual Basic) Ändern Sie den Zugriffsmodifizierer von Private in Protected, und fügen Sie das Overridable-Schlüsselwort hinzu, sodass der Handlercode etwa wie folgt aussieht:

    Protected Overridable Sub Timer1_Tick(ByVal sender As Object, _
   ByVal e As System.EventArgs) Handles Timer1.Tick
   ' Causes the label to display the current time  
   lblDisplay.Text = Format(Now, "hh:mm:ss")
End Sub

    – oder –

    (Visual C#) Ändern Sie den Zugriffsmodifizierer von private in protected, und fügen Sie das virtual-Schlüsselwort hinzu, sodass der Handlercode etwa wie folgt aussieht:

    protected virtual void timer1_Tick(object sender, System.EventArgs
   e)
{
   // Causes the label to display the current time.
   lblDisplay.Text = DateTime.Now.ToLongTimeString(); 
}

  4. Klicken Sie im Menü Datei auf Alle speichern.

  5. (Nur Visual Basic) Geben Sie im Dialogfeld Projekt speichern für das Projekt ctlDevClockLib den gewünschten Speicherort an.

Testen des Steuerelements

Diese einfache Geräteanwendung dient als Testcontainer für das Steuerelement.

So erstellen Sie das Steuerelement und einen Testcontainer

  1. Klicken Sie im Menü Erstellen auf Erstellen (oder ctlDevClockLib erstellen).

  2. Zeigen Sie im Menü Datei auf Hinzufügen, und klicken Sie auf Neues Projekt.

  3. Klicken Sie im Dialogfeld Neues Projekt hinzufügen im Bereich Projekttypen auf Intelligentes Gerät und im Bereich Vorlagen auf Projekt für intelligente Geräte.

  4. Geben Sie im Feld Name die Zeichenfolge Test ein, und klicken Sie dann auf OK.

  5. Wählen Sie im Dialogfeld Neues Projekt für intelligente Geräte hinzufügen im Dropdownmenü Zielplattform die Option Pocket PC 2003 aus, wählen Sie im Dropdownmenü .NET Compact Framework die Option .NET Compact Framework Version 2.0 aus, klicken Sie im Bereich Vorlagen auf Geräteanwendung, und klicken Sie auf OK.

  6. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt Test, und klicken Sie dann auf Als Startprojekt festlegen.

  7. Klicken Sie mit der rechten Maustaste auf das Projekt Test, und klicken Sie dann auf Verweis hinzufügen.

  8. Klicken Sie im Dialogfeld Verweis hinzufügen auf die Registerkarte Projekte, und doppelklicken Sie dann auf ctlDevClockLib.

  9. Suchen Sie in der Toolbox die Registerkarte ctlDevClockLib-Komponenten, und doppelklicken Sie dann auf die Komponente ctlDevClock.

    Das Steuerelement wird in den Designer geladen.

  10. Klicken Sie im Menü Debuggen auf Starten (oder Debuggen starten).

  11. Wählen Sie im Dialogfeld Bereitstellen die Option Pocket PC 2003 SE-Emulator aus, und klicken Sie auf Bereitstellen.

Siehe auch

Konzepte

Empfehlungen zum Typ von Steuerelementen

Weitere Ressourcen

Entwickeln von Windows Forms-Steuerelementen zur Entwurfszeit