Informazioni dettagliate: aggiunta di proprietà con valori denominati

Articolo
09/12/2008

Aggiornamento: novembre 2007

In questa lezione verranno fornite informazioni sull'aggiunta al controllo utente di una proprietà contenente un elenco di valori.

Valori denominati

Le proprietà aggiunte al controllo utente fino a questo punto utilizzano tutte valori stringa, ma esistono tipi di proprietà molto diversi. Talvolta sarà possibile fornire un elenco di valori preimpostati tra i quali scegliere, come la proprietà SizeMode del controllo PictureBox impostata in una lezione precedente.

Si supponga, ad esempio, che si desideri creare una proprietà per l'oggetto NamesControl che consenta di scegliere la modalità di visualizzazione del nome nell'etichetta FullName. È necessario un elenco di valori tra i quali scegliere: prima il nome, prima il cognome, solo nome e cognome e così via.

In Visual Basic è possibile creare un'enumerazione contenente i valori desiderati. Per "enumerazione" si intende in questo caso un "elenco numerato". In Visual Basic i numeri vengono memorizzati automaticamente, in modo che sia possibile fare riferimento ai valori in base al nome. Per dichiarare un'enumerazione è possibile utilizzare la parola chiave Enum, come nell'esempio riportato di seguito.

Public Enum Display
    FirstMiddleLast
    FirstLast
    LastFirstMiddle
    LastFirst
End Enum

Una volta creata un'enumerazione, è possibile utilizzarla come qualsiasi altro tipo di dati. Per aggiungere una proprietà che visualizzi un elenco di valori, è necessario dichiarare innanzitutto una variabile dello stesso tipo di dati di Enum e quindi una proprietà dello stesso tipo di dati. In fase di progettazione, nella finestra Proprietà verrà visualizzato un elenco dei valori contenuti nell'enumerazione.

Procedura

Per aggiungere una proprietà che visualizzi un elenco di valori

Aprire il progetto NamesUserControl creato nella lezione precedente. Se il progetto non è stato salvato, sarà necessario tornare prima alla lezione precedente Aggiunta di codice al controllo utente e completare le procedure indicate in tale lezione.
In Esplora soluzioni, selezionare NamesControl.vb e, quindi, nel menu Visualizza fare clic su Codice.

Nell'editor di codice aggiungere il codice riportato di seguito per creare un'enumerazione.

Public Enum Display
    FirstMiddleLast
    FirstLast
    LastFirstMiddle
    LastFirst
End Enum

Aggiungere il codice riportato di seguito per aggiungere una nuova proprietà.

Private DisplayStyleList As Display 
Property DisplayStyle() As Display
    Get
        Return DisplayStyleList
    End Get
    Set(ByVal value As Display)
        DisplayStyleList = value
    End Set
End Property

Eliminare il codice esistente nel gestore eventi FirstName_TextChanged e sostituirlo con il codice riportato di seguito.

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

Premere F5 per eseguire il programma. Inserire il proprio nome, cognome e secondo nome nelle tre caselle di testo.
In Test Container controllo utente,scorrere fino alla fine della griglia Proprietàe selezionare la proprietà DisplayStyle. Selezionare un altro valore, quindi modificare il testo di una delle caselle per visualizzarne il risultato nell'etichetta.
Scegliere Salva tutto dal menu File per salvare il lavoro.

Passaggi successivi

In questa lezione è stato descritto come utilizzare un'enumerazione per creare una proprietà che disponga di un elenco di valori. Nella lezione successiva verrà descritto come testare un controllo utente inserendolo in un form.

Lezione successiva: Test del controllo utente