Genauere Betrachtung: Hinzufügen von Eigenschaften mit benannten Werten

Artikel
09/02/2008

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

Ö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.
Wählen Sie im Projektmappen-Explorer die Datei NamesControl.vb aus, und klicken Sie anschließend im Menü Ansicht auf die Option Code.

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

Public Enum Display
    FirstMiddleLast
    FirstLast
    LastFirstMiddle
    LastFirst
End Enum

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

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

Drücken Sie F5, um das Programm auszuführen. Geben Sie Ihren Vornamen, Nachnamen und zweiten Vornamen in die drei Textfelder ein.
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.
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