Condividi tramite


Panoramica del controllo utente

Un controllo utente è una raccolta di controlli Windows Form incapsulati in un contenitore comune. Questo tipo di controllo viene definito controllo composito . I controlli contenuti vengono detti controlli costitutivi . I controlli utente derivano dalla classe UserControl.

I controlli utente sono progettati come Forme, con un progettista visivo. È possibile creare, disporre e modificare i controlli costitutivi tramite la finestra di progettazione visiva. Gli eventi di controllo e la logica vengono scritti esattamente come quando si progetta un form. Il controllo utente viene posizionato su un modulo esattamente come qualsiasi altro controllo.

I controlli utente sono utilizzabili dal progetto in cui vengono creati o in altri progetti che hanno riferimento alla libreria del controllo utente.

Controlli costitutivi

I controlli costitutivi sono disponibili per il controllo utente e l'utente dell'app può interagire con essi singolarmente in fase di esecuzione, ma le proprietà e i metodi dichiarati dai controlli costitutivi non vengono esposti al consumer. Ad esempio, se si inserisce un controllo TextBox e Button sul controllo utente, l'evento Click del pulsante viene gestito internamente dal controllo utente, ma non dal form in cui è posizionato il controllo utente.

I membri di un controllo costitutivo possono essere esposti dal controllo utente. Per altre informazioni, vedere Procedura: Esporre le proprietà dei controlli costitutivi.

Aggiungere un controllo utente a un progetto

Dopo aver creato un nuovo progetto, usare i modelli di Visual Studio per creare un controllo utente. I passaggi seguenti illustrano come aggiungere un controllo utente al progetto:

  1. In Visual Studio, trova il riquadro Esplora progetti. Fare clic con il pulsante destro del mouse sul progetto e scegliere Aggiungi>controllo utente (Windows Form).

    Fare clic con il pulsante destro del mouse su Esplora soluzioni di Visual Studio per aggiungere un controllo utente a un progetto di Windows Form

  2. Nella casella Nome inserisci un nome per il controllo utente. Visual Studio fornisce un nome predefinito e univoco che è possibile usare. Premere quindi Aggiungi.

    Finestra di dialogo Aggiungi elemento in Visual Studio per Windows Forms

Dopo aver creato il controllo utente, Visual Studio apre la finestra di progettazione:

Il progettista di controlli utente in Visual Studio per Windows Forms

Per un esempio di controllo utente funzionante, vedere Come creare un controllo utente.