Procedura dettagliata: Ereditare da un controllo Windows Form con C#

Articolo
06/02/2023

Con C#, è possibile creare potenti controlli personalizzati tramite ereditarietà. L'ereditarietà consente di creare nuovi controlli che non solo conservano tutte le funzionalità proprie dei controlli Windows Forms standard, ma includono anche funzionalità personalizzate. In questa procedura verrà creato un controllo ereditato semplice denominato ValueButton. Questo pulsante erediterà la funzionalità dal controllo Windows Form Button standard ed esporrà una proprietà personalizzata denominata ButtonValue.

Creare il progetto

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

Per creare la libreria di controlli ValueButtonLib e il controllo ValueButton

In Visual Studio creare un nuovo progetto libreria di controlli Windows Form e denominarlo ValueButtonLib.

Per impostazione predefinita il nome del progetto, ValueButtonLib, verrà assegnato anche allo spazio dei nomi radice. Lo spazio dei nomi radice 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 altre informazioni, vedere Spazi dei nomi.
In Esplora soluzioni fare clic con il pulsante destro del mouse su UserControl1.cs e scegliere Rinomina dal menu di scelta rapida. Modificare il nome del file in ValueButton.cs. Scegliere il pulsante Sì quando richiesto per rinominare tutti i riferimenti all'elemento di codice 'UserControl1'.
In Esplora soluzioni fare clic con il pulsante destro del mouse su ValueButton.cs e scegliere Visualizza codice.
Individuare la riga dell'istruzione class , public partial class ValueButtone modificare il tipo da cui questo controllo eredita da UserControl a Button. In questo modo il controllo ereditato eredita tutte le funzionalità del Button controllo.
In Esplora soluzioni aprire il nodo ValueButton.cs per visualizzare il file del codice generato nella finestra di progettazione ValueButton.Designer.cs. Aprire il file nell'editor di codice.
Individuare il InitializeComponent metodo e rimuovere la riga che assegna la AutoScaleMode proprietà . Questa proprietà non esiste nel Button controllo .
Per salvare il progetto, scegliere Salva tutto dal menu File.

Nota

Non è più disponibile alcuna finestra di progettazione. Poiché il Button controllo esegue il proprio disegno, non è possibile modificarne l'aspetto nella finestra di progettazione. La rappresentazione visiva sarà esattamente uguale a quella della classe da cui eredita (ovvero , Button) a meno che non venga modificata nel codice. È comunque possibile aggiungere nell'area di progettazione i componenti che non dispongono di elementi dell'interfaccia utente.

Aggiungere una proprietà al controllo ereditato

Un possibile utilizzo dei controlli Windows Forms ereditati è la creazione di controlli aventi aspetto e funzionalità identici ai controlli standard Windows Forms, 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.cs, quindi scegliere Visualizza codice dal menu di scelta rapida.
Individuare l'istruzione class. Sotto { digitare il seguente codice:
```
// Creates the private variable that will store the value of your
// property.
private int varValue;
// Declares the property.
public int ButtonValue
{
   // Sets the method for retrieving the value of your property.
   get
   {
      return varValue;
   }
   // Sets the method for setting the value of your property.
   set
   {
      varValue = value;
   }
}
```
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.

Testare il 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

Nel menu Compila scegliere Compila soluzione. La compilazione dovrebbe essere completata senza errori del compilatore o avvisi.

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 Windows sotto il nodo Visual C# e fare clic su Windows Forms Application.
Nella casella Nome immettere Test.
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 Aggiungi riferimento.
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 clic con il pulsante destro del mouse su Test e scegliere Compila.

Per aggiungere il controllo al modulo

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

Nel modulo 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. Si noti che sono identici alle proprietà esposte da un pulsante standard, ad eccezione del fatto che è presente una proprietà aggiuntiva ButtonValue.
Impostare la proprietà ButtonValue su 5.
Nella scheda Tutti Windows Form della casella degli strumenti fare doppio clic su Etichetta per aggiungere un Label controllo al modulo.
Posizionare l'etichetta al centro del modulo.
Doppio clic su valueButton1.

Nell'editor di codice verrà visualizzato l'evento valueButton1_Click.

Inserire la seguente riga di codice.

label1.Text = valueButton1.ButtonValue.ToString();

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 Forms, ma esporrà una proprietà personalizzata aggiuntiva.