Controlli con supporto incorporato per la creazione da parte del proprietario

Articolo
09/12/2008

Aggiornamento: novembre 2007

Il disegno del proprietario, definito anche disegno personalizzato, in Windows Form è una tecnica per modificare l'aspetto visivo di alcuni controlli.

Nota:
La parola "controllo" in questo argomento viene utilizzata per indicare le classi che derivano da Control o Component.

In genere, Windows gestisce automaticamente la generazione mediante le impostazioni di proprietà come BackColor per determinare l'aspetto di un controllo. Con il disegno personalizzato l'utente assume il controllo del processo di generazione, modificando elementi dell'aspetto non disponibili nelle proprietà. Ad esempio, molti controlli consentono di impostare il colore del testo visualizzato, ma è possibile utilizzare un solo colore. Il disegno personalizzato consente di eseguire operazioni come la visualizzazione di parte del testo in nero e di parte in rosso.

In pratica, il disegno personalizzato è simile alla creazione di elementi grafici in un form. È possibile ad esempio utilizzare metodi grafici in un gestore dell'evento Paint del form per emulare un controllo ListBox. In questo caso, tuttavia, è necessario scrivere un proprio codice per gestire tutte le interazioni dell'utente. Con il disegno personalizzato, il controllo impiega il codice per creare i contenuti mantenendo allo stesso tempo tutte le relative capacità intrinseche. I metodi grafici possono essere utilizzati per disegnare i singoli elementi del controllo o per personalizzarne alcuni aspetti utilizzando allo stesso tempo l'aspetto predefinito di ciascun elemento.

Disegno personalizzato nei controlli di Windows Form

Per eseguire il disegno personalizzato nei controlli che lo supportano, viene di solito impostata una proprietà e vengono gestiti uno o più eventi.

La maggior parte dei controlli che supportano il disegno personalizzato dispone della proprietà OwnerDraw o della proprietà DrawMode che indica se il controllo genererà l'evento o gli eventi relativi al disegno durante il processo di generazione.

I controlli che non dispongono della proprietà OwnerDraw o della proprietà DrawMode includono il controllo DataGridView, che fornisce eventi di disegno che si verificano automaticamente, e il controllo ToolStrip, che viene creato utilizzando una classe esterna per il rendering dotata di eventi relativi al disegno.

Sono disponibili molti tipi diversi di eventi di disegno, ma in genere un evento di disegno viene generato per disegnare un singolo elemento in un controllo. Il gestore eventi riceve un oggetto EventArgs che contiene informazioni sull'elemento disegnato e strumenti che è possibile utilizzare per il disegno. Questo oggetto contiene in genere il numero di indice dell'elemento all'interno dell'insieme padre, una struttura Rectangle che indica i limiti di visualizzazione dell'elemento e un oggetto Graphics per la chiamata ai metodi di disegno. Per alcuni eventi, l'oggetto EventArgs fornisce informazioni aggiuntive sull'elemento e sui metodi che è possibile chiamare per disegnare alcuni aspetti predefiniti dell'elemento, come lo sfondo o un rettangolo di attivazione.

Per creare un controllo riutilizzabile che contenga le personalizzazioni del disegno personalizzato, creare una nuova classe da una classe di controlli che supporti il disegno personalizzato. Piuttosto che gestire gli eventi di disegno, includere il codice del disegno personalizzato in override del metodo OnNomeEvento appropriato o dei metodi presenti nella nuova classe. In questo caso, accertarsi di chiamare il metodo o i metodi OnNomeEvento della classe di base, in modo che gli utenti del controllo possano gestire gli eventi del disegno personalizzato e fornire personalizzazioni aggiuntive.

I controlli Windows Form riportati di seguito supportano il disegno personalizzato in tutte le versioni di .NET Framework.

ListBox
ComboBox
MenuItem (utilizzato da MainMenu eContextMenu)
TabControl

I controlli riportati di seguito supportano il disegno personalizzato solo in .NET Framework versione 2.0:

I controlli riportati di seguito supportano il disegno personalizzato e sono nuovi in .NET Framework versione 2.0:

Nelle sezioni successive vengono forniti dettagli aggiuntivi per ciascuno di questi controlli.

Controlli ListBox e ComboBox

I controlli ListBox e ComboBox consentono il disegno di singoli elementi nel controllo utilizzando la stessa dimensione o dimensioni variabili.

Nota:
Sebbene il controllo CheckedListBox sia derivato dal controllo ListBox, non supporta il disegno personalizzato.

Per disegnare ciascun elemento con le stesse dimensioni, impostare la proprietà DrawMode su OwnerDrawFixed e gestire l'evento DrawItem.

Per disegnare ciascun elemento con dimensioni diverse, impostare la proprietà DrawMode su OwnerDrawVariable e gestire entrambi gli eventi MeasureItem e DrawItem. L'evento MeasureItem consente di indicare la dimensione di un elemento prima che l'evento DrawItem si verifichi per tale elemento.

Per ulteriori informazioni, inclusi gli esempi di codice, vedere i seguenti argomenti:

Componente MenuItem

Il componente MenuItem rappresenta una singola voce di menu in un componente MainMenu o ContextMenu.

Per creare un elemento MenuItem, impostarne la proprietà OwnerDraw su true e gestirne il relativo evento DrawItem. Per personalizzare la dimensione della voce di menu prima che si verifichi l'evento DrawItem, gestire l'evento MeasureItem dell'elemento.