Controlli con supporto predefinito per il disegno da parte del proprietario

Articolo
06/02/2023

Il disegno da parte del proprietario in Windows Form, noto anche come disegno personalizzato, è una tecnica che consente di modificare l'aspetto visivo di alcuni controlli.

Nota

La parola "control" in questo argomento viene usata per indicare le classi che derivano da Control o Component.

In genere, Windows gestisce automaticamente il disegno usando le impostazioni delle proprietà, ad BackColor esempio per determinare l'aspetto di un controllo. Con il disegno da parte del proprietario, si acquisisce la precedenza sul processo di disegno, modificando elementi dell'aspetto non disponibili quando si usano le proprietà. Molti controlli, ad esempio, consentono di impostare il colore del testo visualizzato, ma è previsto un limite di un solo colore. Il disegno da parte del proprietario consente, ad esempio, di visualizzare parte del testo in nero e parte in rosso.

Il disegno da parte del proprietario è in pratica simile al disegno di elementi grafici in un form. Ad esempio, è possibile usare metodi grafici in un gestore per l'evento del Paint modulo per emulare un ListBox controllo, ma è necessario scrivere codice personalizzato per gestire tutte le interazioni dell'utente. Con il disegno da parte del proprietario, il controllo usa il codice per disegnare i contenuti, ma mantiene tutte le funzionalità intrinseche. È possibile usare metodi Graphics per disegnare ogni elemento nel controllo o per personalizzare alcuni dettagli di ogni elemento mentre si usa l'aspetto predefinito per altri dettagli di ogni elemento.

Disegno da parte del proprietario nei controlli Windows Form

Per eseguire il disegno da parte del proprietario nei controlli che lo supportano, in genere è necessario impostare una proprietà e gestire uno o più eventi.

La maggior parte dei controlli che supportano il disegno da parte del proprietario ha una proprietà OwnerDraw o DrawMode che indica se il controllo genera uno o più eventi correlati al disegno quando disegna se stesso.

I controlli senza la proprietà OwnerDraw o DrawMode includono il controllo DataGridView, che fornisce eventi di disegno che si verificano automaticamente, e il controllo ToolStrip, che viene disegnato usando una classe di rendering esterna con i propri eventi correlati al disegno.

Sono disponibili molti tipi di eventi di disegno diversi, ma un evento di disegno tipico si verifica per disegnare un singolo elemento in un controllo. Il gestore eventi riceve un oggetto EventArgs che contiene informazioni sull'elemento che viene disegnato e sugli strumenti che è possibile usare per disegnarlo. Ad esempio, questo oggetto contiene in genere il numero di indice dell'elemento all'interno della raccolta padre, un Rectangle oggetto che indica i limiti di visualizzazione dell'elemento e un Graphics oggetto per chiamare i metodi di disegno. Per alcuni eventi, l'oggetto EventArgs fornisce informazioni aggiuntive sull'elemento e sui metodi che è possibile chiamare per disegnare alcuni dettagli dell'elemento per impostazione predefinita, ad esempio lo sfondo o il rettangolo dello stato attivo.

Per creare un controllo riutilizzabile contenente le personalizzazioni disegnate dal proprietario, creare una nuova classe che deriva da una classe di controlli che supporta il disegno da parte del proprietario. Invece di gestire gli eventi di disegno, includere il codice del disegno da parte del proprietario negli override per uno o più metodi OnEventName appropriati nella nuova classe. In questo caso, verificare di chiamare il metodo o i metodi OnEventName della classe base in modo che gli utenti del controllo possano gestire gli eventi di disegno da parte del proprietario e creare personalizzazioni aggiuntive.

I controlli Windows Form seguenti supportano il disegno da parte del proprietario in tutte le versioni di .NET Framework:

ListBox
ComboBox
MenuItem (usato da MainMenu e ContextMenu)
TabControl

I controlli seguenti supportano il disegno proprietario solo in .NET Framework 2.0:

I controlli seguenti supportano il disegno del proprietario e sono nuove in .NET Framework 2.0:

Le sezioni seguenti contengono altre informazioni dettagliate su ogni controllo.

Controlli ListBox e ComboBox

I ListBox controlli e ComboBox consentono di disegnare singoli elementi nel controllo in un'unica dimensione o in dimensioni variabili.

Nota

Anche se il CheckedListBox controllo è derivato dal ListBox controllo , non supporta il disegno del proprietario.

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

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

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

Componente MenuItem

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

Per disegnare un MenuItemoggetto , impostarne la OwnerDraw proprietà su true e gestire il relativo DrawItem evento. Per personalizzare le dimensioni della voce di menu prima che si verifichi l'evento DrawItem, gestire l'evento MeasureItem dell'elemento.