DrawItemEventHandler Delegato

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DrawItemEventHandler.cs

Rappresenta il metodo che gestirà l'evento DrawItem di un controllo ComboBox, ListBox, MenuItem o TabControl.

C#

public delegate void DrawItemEventHandler(object? sender, DrawItemEventArgs e);

Parametri

sender

Object

Origine dell'evento.

e

DrawItemEventArgs

Oggetto DrawItemEventArgs che contiene i dati dell'evento.

Esempio

Nell'esempio di codice seguente viene illustrato un menu con una voce di menu disegnata dal proprietario. In questo esempio viene usata l'istruzione e l'operatore AddHandlerAddressOf per designare un delegato per gestire l'evento MenuItem.DrawItem . Per eseguire l'esempio incollarlo in un modulo che importa gli spazi dei nomi System, System.Windows.Forms e System.Drawing. Assicurarsi che tutti gli eventi siano associati ai metodi di gestione degli eventi.

C#

// Declare the MainMenu control.
internal System.Windows.Forms.MainMenu MainMenu1;

// Declare MenuItem2 as With-Events because it will be user drawn.
internal System.Windows.Forms.MenuItem MenuItem2;

private void InitializeMenu()
{

    // Create MenuItem1, which will be drawn by the operating system.
    MenuItem MenuItem1 = new MenuItem("Regular Menu Item");

    // Create MenuItem2.
    MenuItem2 = new MenuItem("Custom Menu Item");

    // Set OwnerDraw property to true. This requires handling the
    // DrawItem event for this menu item.
    MenuItem2.OwnerDraw = true;

    //Add the event-handler delegate to handle the DrawItem event.
    MenuItem2.DrawItem += new DrawItemEventHandler(DrawCustomMenuItem);
    
    // Add the items to the menu.
    MainMenu1 = new MainMenu(new MenuItem[]{MenuItem1, MenuItem2});																													  

    // Add the menu to the form.
    this.Menu = this.MainMenu1;
}

// Draw the custom menu item.
private void DrawCustomMenuItem(object sender, 
    DrawItemEventArgs e)
{

    // Cast the sender to MenuItem so you can access text property.
    MenuItem customItem = (MenuItem) sender;

    // Create a Brush and a Font to draw the MenuItem.
    System.Drawing.Brush aBrush = System.Drawing.Brushes.DarkMagenta;
    Font aFont = new Font("Garamond", 10, 
        FontStyle.Italic, GraphicsUnit.Point);

    // Get the size of the text to use later to draw an ellipse
    // around the item.
    SizeF stringSize = e.Graphics.MeasureString(
        customItem.Text, aFont);

    // Draw the item and then draw the ellipse.
    e.Graphics.DrawString(customItem.Text, aFont, 
        aBrush, e.Bounds.X, e.Bounds.Y);
    e.Graphics.DrawEllipse(new Pen(System.Drawing.Color.Black, 2),
        new Rectangle(e.Bounds.X, e.Bounds.Y, 
        (System.Int32)stringSize.Width,
        (System.Int32)stringSize.Height));
}

Commenti

Quando si crea un delegato DrawItemEventArgs, si identifica il metodo che gestirà l'evento. Per associare l'evento al gestore eventi in uso, aggiungere all'evento un'istanza del delegato. Il gestore eventi viene chiamato ogni volta che si verifica l'evento, a meno che non venga rimosso il delegato. Per altre informazioni sui delegati del gestore eventi, vedere Gestione e generazione di eventi.

Metodi di estensione

Si applica a

Vedi anche

• DrawItemEventArgs
• ComboBox
• ListBox
• MenuItem
• TabControl