Procedura dettagliata: eredità da un controllo Windows Form con Visual Basic

Articolo
08/11/2011

Visual Basic consente di creare controlli personalizzati avanzati sfruttando l'ereditarietà. L'ereditarietà consente di creare nuovi controlli che non solo conservano tutte le funzionalità proprie dei controlli Windows Form standard, ma includono anche funzionalità personalizzate. In questa procedura verrà creato un controllo ereditato semplice denominato ValueButton. Questo pulsante eredita la funzionalità dal controllo standard Windows Form Button ed espone una proprietà personalizzata denominata ButtonValue.

Nota

È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida a seconda delle impostazioni attive o dell'edizione del programma. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Gestione delle impostazioni.

Creazione del progetto

Quando si crea un nuovo progetto è necessario specificarne il nome per impostare lo spazio dei nomi di primo livello, il nome dell'assembly e il nome del progetto e per assicurarsi che il componente predefinito sia inserito nello spazio dei nomi corretto.

Per creare la libreria di controlli ValueButtonLib e il controllo ValueButton

Scegliere Nuovo dal menu File, quindi fare clic su Progetto. Verrà visualizzata la finestra di dialogo Nuovo progetto.
Selezionare il modello di progetto Libreria di controlli Windows Form dall'elenco dei progetti di Visual Basic, quindi digitare ValueButtonLib nella casella Nome.

Per impostazione predefinita il nome del progetto,ValueButtonLib, verrà assegnato anche allo spazio dei nomi di primo livello. Lo spazio dei nomi di primo livello viene utilizzato per qualificare i nomi dei componenti dell'assembly. Se ad esempio due assembly forniscono componenti denominati ValueButton, sarà possibile specificare il componente ValueButton utilizzando ValueButtonLib.ValueButton. Per ulteriori informazioni, vedere Spazi dei nomi in Visual Basic.
In Esplora soluzioni fare clic con il pulsante destro del mouse su UserControl1.vb, quindi scegliere Rinomina. Cambiare il nome del file in ValueButton.vb. Scegliere il pulsante Sì quando richiesto per rinominare tutti i riferimenti all'elemento di codice "UserControl1".
In Esplora soluzioni fare clic sul pulsante Mostra tutti i file.
Aprire il nodo ValueButton.vb per visualizzare il file del codice generato nella finestra di progettazione ValueButton.Designer.vb. Aprire il file nell'editor di codice.
Individuare l'istruzione Class, Partial Public Class ValueButton, e cambiare il tipo da cui il controllo eredita da UserControl in Button. In tal modo il controllo ereditato potrà ereditare tutte le funzionalità del controllo Button.
Individuare il metodo InitializeComponent e rimuovere la riga che assegna la proprietà AutoScaleMode. Tale proprietà non esiste nel controllo Button.
Per salvare il progetto, scegliere Salva tutto dal menu File.

Si noti che non sarà più disponibile alcuna finestra di progettazione. Poiché il controllo Button esegue il proprio disegno, non è possibile modificarne l'aspetto nella finestra di progettazione. La rappresentazione visiva di tale controllo sarà identica a quella della classe da cui eredita, vale a dire Button, a meno che non venga modificata nel codice.

Nota

È comunque possibile aggiungere nell'area di progettazione i componenti che non dispongono di elementi dell'interfaccia utente.

Aggiunta di una proprietà al controllo ereditato

Un possibile utilizzo dei controlli Windows Form ereditati è la creazione di controlli aventi aspetto e funzionalità identici ai controlli standard Windows Form, ma che espongono proprietà personalizzate. In questa sezione verrà illustrata la modalità di aggiunta della proprietà ButtonValue al controllo.

Per aggiungere la proprietà Value

In Esplora soluzioni, fare clic con il pulsante destro del mouse su ValueButton.vb, quindi scegliere Visualizza codice dal menu di scelta rapida.
Individuare l'istruzione Public Class ValueButton. Sotto questa istruzione digitare il seguente codice:

[Visual Basic]
```
' Creates the private variable that will store the value of your 
' property.
Private varValue as integer
' Declares the property.
Property ButtonValue() as Integer
' Sets the method for retrieving the value of your property.
   Get
      Return varValue
   End Get
' Sets the method for setting the value of your property.
   Set(ByVal Value as Integer)
      varValue = Value
   End Set
End Property
```
Questo codice consente di impostare i metodi per la memorizzazione e il recupero della proprietà ButtonValue. L'istruzione Get consente di impostare il valore restituito sul valore memorizzato nella variabile privata varValue, mentre l'istruzione Set consente di impostare il valore della variabile privata mediante la parola chiave Value.
Per salvare il progetto, scegliere Salva tutto dal menu File.

Test del controllo

I controlli non sono progetti autonomi e devono pertanto essere inseriti in un contenitore. Per testare il controllo, è necessario creare un progetto di test in cui eseguirlo. È inoltre necessario rendere il controllo accessibile al progetto di test compilandolo. In questa sezione verrà illustrato come compilare un controllo ed eseguirne il test in un Windows Form.

Per compilare il controllo

Scegliere Compila soluzione dal menu Compila.

La compilazione dovrebbe essere completata correttamente senza avvisi o errori di compilazione.

Per creare un progetto di test

Scegliere Aggiungi dal menu File, quindi fare clic su Nuovo progetto. Verrà visualizzata la finestra di dialogo Aggiungi nuovo progetto.
Selezionare il nodo dei progetti di Visual Basic, quindi fare clic su Applicazione Windows Form.
Nella casella Nome, digitare Test.
In Esplora soluzioni fare clic sul pulsante Mostra tutti i file.
In Esplora soluzioni, fare clic con il pulsante destro del mouse sul nodo Riferimenti del progetto di test, quindi scegliere Aggiungi riferimento dal menu di scelta rapida per visualizzare la finestra di dialogo corrispondente.
Fare clic sulla scheda Progetti.
Scegliere la scheda Progetti. Il progetto ValueButtonLib verrà elencato in Nome progetto. Fare doppio clic sul progetto per cui si desidera aggiungere il riferimento al progetto di test.
In Esplora soluzioni, fare doppio clic su Test e scegliere Compila.

Per aggiungere il controllo al form

In Esplora soluzioni, fare clic con il pulsante destro del mouse su Form1.vb, quindi scegliere Visualizza finestra di progettazione dal menu di scelta rapida.
Nella Casella degli strumenti fare clic su Componenti ValueButtonLib. Fare doppio clic su ValueButton.

Nel form verrà visualizzato un controllo ValueButton.
Fare clic con il pulsante destro del mouse su ValueButton, quindi scegliere Proprietà dal menu di scelta rapida.
Nella finestra Proprietà esaminare le proprietà del controllo. Tali proprietà sono identiche a quelle esposte da un pulsante standard, con la differenza che è disponibile anche la proprietà ButtonValue.
Impostare la proprietà ButtonValue su 5.
Nella scheda Tutti i Windows Form della Casella degli strumenti fare doppio clic su Etichetta per aggiungere un controllo Label al form.
Posizionare l'etichetta al centro del form.
Doppio clic su ValueButton1.

Nell'editor di codice verrà visualizzato l'evento ValueButton1_Click.
Digitare la seguente riga di codice:

[Visual Basic]
```
Label1.Text = CStr(ValueButton1.ButtonValue)
```
In Esplora soluzioni, fare clic con il pulsante destro del mouse su Test quindi scegliere Imposta come progetto di avvio dal menu di scelta rapida.
Scegliere Avvia debug dal menu Debug.

Viene visualizzato Form1.
Fare clic su Valuebutton1.

Il numero "5" verrà visualizzato in Label1, a significare che la proprietà ButtonValue del controllo ereditato è stata passata a Label1 mediante il metodo ValueButton1_Click. Il controllo ValueButton erediterà tutte le funzionalità del pulsante standard per Windows Form, ma esporrà una proprietà personalizzata aggiuntiva.