Freigeben über


Genauere Betrachtung: Hinzufügen von Eigenschaften mit benannten Werten

Aktualisiert: November 2007

In dieser Lektion erfahren Sie, wie Sie dem Benutzersteuerelement eine Eigenschaft hinzufügen, die eine Liste von Werten enthält.

Benannte Werte

Alle bisher zum Benutzersteuerelement hinzugefügten Eigenschaften nehmen Zeichenfolgenwerte auf. Es gibt jedoch verschiedene Typen von Eigenschaften. Gelegentlich müssen Sie vielleicht eine Liste vorher festgelegter Werte zur Auswahl bereitstellen, wie die SizeMode-Eigenschaft des PictureBox-Steuerelements, die Sie in einer der vorhergehenden Lektionen festgelegt haben.

Angenommen, Sie möchten eine Eigenschaft für das NamesControl-Steuerelement erstellen, mit der Sie auswählen können, auf welche Weise die FullName-Bezeichnung den Namen anzeigt. Dazu benötigen Sie eine Liste der Werte, aus denen Sie auswählen möchten: Vorname zuerst, Nachname zuerst, nur Vor- und Nachname usw.

In Visual Basic können Sie eine Enumeration erstellen, die die gewünschten Werte enthält. "Enumeration" ist lediglich eine andere Bezeichnung für "nummerierte Liste". Visual Basic speichert die Nummern für Sie, sodass Sie über den Namen auf die Werte verweisen können. Eine Enumeration wird mit dem Enum-Schlüsselwort deklariert, wie im folgenden Beispiel gezeigt.

Public Enum Display
    FirstMiddleLast
    FirstLast
    LastFirstMiddle
    LastFirst
End Enum

Wenn Sie eine Enumeration erstellt haben, können Sie diese wie jeden anderen Datentyp verwenden. Zum Hinzufügen einer Eigenschaft, die eine Werteliste anzeigt, deklarieren Sie zunächst eine Variable desselben Datentyps wie Enum und anschließend eine Eigenschaft mit diesem Datentyp. Zur Entwurfszeit wird eine Liste der in der Enumeration enthaltenen Werte im Fenster Eigenschaften angezeigt.

Übung

So fügen Sie eine Eigenschaft hinzu, die eine Liste von Werten anzeigt

  1. Öffnen Sie das in der vorigen Lektion erstellte NamesUserControl-Projekt. Wenn Sie das Projekt nicht gespeichert haben, müssen Sie zuerst zur vorherigen Lektion, Hinzufügen von Code zum Benutzersteuerelement, zurückkehren und die Prozeduren in der Lektion abschließen.

  2. Wählen Sie im Projektmappen-Explorer die Datei NamesControl.vb aus, und klicken Sie anschließend im Menü Ansicht auf die Option Code.

  3. Fügen Sie im Code-Editor folgenden Code hinzu, um eine Enumeration zu erstellen.

    Public Enum Display
        FirstMiddleLast
        FirstLast
        LastFirstMiddle
        LastFirst
    End Enum
    
  4. Fügen Sie folgenden Code hinzu, um eine neue Eigenschaft hinzuzufügen.

    Private DisplayStyleList As Display 
    Property DisplayStyle() As Display
        Get
            Return DisplayStyleList
        End Get
        Set(ByVal value As Display)
            DisplayStyleList = value
        End Set
    End Property
    
  5. Löschen Sie den vorhandenen Code im FirstName_TextChanged-Ereignishandler, und ersetzen Sie ihn durch folgenden Code.

    Select Case DisplayStyleList
        Case Display.FirstLast
            FullName.Text = FirstName.Text & " " & LastName.Text
        Case Display.FirstMiddleLast
            FullName.Text = FirstName.Text & " " & MiddleName.Text & " " & LastName.Text
        Case Display.LastFirst
            FullName.Text = LastName.Text & ", " & FirstName.Text
        Case Display.LastFirstMiddle
            FullName.Text = LastName.Text & ", " & FirstName.Text & " " & MiddleName.Text
    End Select
    
  6. Drücken Sie F5, um das Programm auszuführen. Geben Sie Ihren Vornamen, Nachnamen und zweiten Vornamen in die drei Textfelder ein.

  7. Führen Sie im Testcontainer für Benutzersteuerelemente einen Bildlauf zum Ende des Eigenschaftenrasters aus, und wählen Sie die DisplayStyle-Eigenschaft aus. Wählen Sie einen anderen Wert aus, und ändern Sie anschließend den Text in einem der Textfelder, um die Auswirkungen auf die Bezeichnung anzuzeigen.

  8. Klicken Sie im Menü Datei auf Alle speichern, um Ihre Änderungen zu speichern.

Nächste Schritte

In dieser Lektion haben Sie gelernt, wie mit einer Enumeration eine Eigenschaft mit einer Liste von Werten erstellt wird. In der nächsten Lektion lernen Sie, wie Sie das Benutzersteuerelement testen, indem Sie es auf einem Formular platzieren.

Nächste Lektion: Testen des Benutzersteuerelements

Siehe auch

Aufgaben

Hinzufügen von Code zum Benutzersteuerelement

Weitere Ressourcen

Sichtbare Objekte: Erstellen des ersten Benutzersteuerelements

Programmieren mit Objekten: Verwenden von Klassen

Visual Basic-Einführung