DrawItemEventArgs Classe

Définition

Fournit des données pour l'événement DrawItem.Provides data for the DrawItem event.

public ref class DrawItemEventArgs : EventArgs
public class DrawItemEventArgs : EventArgs
type DrawItemEventArgs = class
    inherit EventArgs
Public Class DrawItemEventArgs
Inherits EventArgs
Héritage
DrawItemEventArgs
Dérivé

Exemples

L’exemple suivant montre comment créer des éléments owner- ListBox drawn.The following example demonstrates how to create owner-drawn ListBox items. Le code utilise la DrawMode propriété pour spécifier que les éléments dessinés sont de taille fixe DrawItem et l’événement pour effectuer le dessin ListBoxde chaque élément dans.The code uses the DrawMode property to specify that the items drawn are fixed sized and the DrawItem event to perform the drawing of each item into the ListBox. L’exemple de code utilise les propriétés et les méthodes DrawItemEventArgs de la classe passée comme paramètre au gestionnaire d’événements pour dessiner les éléments.The example code uses the properties and methods of the DrawItemEventArgs class passed as a parameter to the event handler to draw the items. Cet exemple suppose qu’un ListBox contrôle nommé listBox1 a été ajouté à un formulaire et que l' DrawItem événement est géré par le gestionnaire d’événements défini dans l’exemple de code.This example assumes that a ListBox control that is named listBox1 has been added to a form and that the DrawItem event is handled by the event handler defined in the example code. L’exemple suppose également que des éléments ont été ajoutés au ListBox avec le texte «Apple», «orange» et «Plum» dans cet ordre.The example also assumes that items have been added to the ListBox with the text of "Apple", "Orange", and "Plum" in that order.

private ListBox ListBox1 = new ListBox();
private void InitializeListBox()
{
    ListBox1.Items.AddRange(new Object[] 
        { "Red Item", "Orange Item", "Purple Item" });
    ListBox1.Location = new System.Drawing.Point(81, 69);
    ListBox1.Size = new System.Drawing.Size(120, 95);
    ListBox1.DrawMode = DrawMode.OwnerDrawFixed;
    ListBox1.DrawItem += new DrawItemEventHandler(ListBox1_DrawItem);
    Controls.Add(ListBox1);
}

private void ListBox1_DrawItem(object sender, 
    System.Windows.Forms.DrawItemEventArgs e)
{
    // Draw the background of the ListBox control for each item.
    e.DrawBackground();
    // Define the default color of the brush as black.
    Brush myBrush = Brushes.Black;

    // Determine the color of the brush to draw each item based 
    // on the index of the item to draw.
    switch (e.Index)
    {
        case 0:
            myBrush = Brushes.Red;
            break;
        case 1:
            myBrush = Brushes.Orange;
            break;
        case 2:
            myBrush = Brushes.Purple;
            break;
    }

    // Draw the current item text based on the current Font 
    // and the custom brush settings.
    e.Graphics.DrawString(ListBox1.Items[e.Index].ToString(), 
        e.Font, myBrush, e.Bounds, StringFormat.GenericDefault);
    // If the ListBox has focus, draw a focus rectangle around the selected item.
    e.DrawFocusRectangle();
}
Private WithEvents ListBox1 As New ListBox()

Private Sub InitializeListBox() 
    ListBox1.Items.AddRange(New Object() _
        {"Red Item", "Orange Item", "Purple Item"})
    ListBox1.Location = New System.Drawing.Point(81, 69)
    ListBox1.Size = New System.Drawing.Size(120, 95)
    ListBox1.DrawMode = DrawMode.OwnerDrawFixed
    Controls.Add(ListBox1)

End Sub

Private Sub ListBox1_DrawItem(ByVal sender As Object, _
 ByVal e As System.Windows.Forms.DrawItemEventArgs) _
 Handles ListBox1.DrawItem

    ' Draw the background of the ListBox control for each item.
    e.DrawBackground()

    ' Define the default color of the brush as black.
    Dim myBrush As Brush = Brushes.Black

    ' Determine the color of the brush to draw each item based on   
    ' the index of the item to draw.
    Select Case e.Index
        Case 0
            myBrush = Brushes.Red
        Case 1
            myBrush = Brushes.Orange
        Case 2
            myBrush = Brushes.Purple
    End Select

    ' Draw the current item text based on the current 
    ' Font and the custom brush settings.
    e.Graphics.DrawString(ListBox1.Items(e.Index).ToString(), _
        e.Font, myBrush, e.Bounds, StringFormat.GenericDefault)

    ' If the ListBox has focus, draw a focus rectangle around  _ 
    ' the selected item.
    e.DrawFocusRectangle()
End Sub

Remarques

L' DrawItem événement est déclenché par owner draw contrôles, tels que les ListBox contrôles ComboBox et.The DrawItem event is raised by owner draw controls, such as the ListBox and ComboBox controls. Il contient toutes les informations nécessaires à l’utilisateur pour peindre l’élément spécifié, y compris l’index de l’élément, Rectanglele et le Graphics sur lequel le dessin doit être effectué.It contains all the information that is needed for the user to paint the specified item, including the item index, the Rectangle, and the Graphics on which the drawing should be done.

Constructeurs

DrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState)

Initialise une nouvelle instance de la classe DrawItemEventArgs pour le contrôle spécifié avec la police spécifiée, l'état, la surface sur laquelle dessiner et les limites à l'intérieur desquelles dessiner.Initializes a new instance of the DrawItemEventArgs class for the specified control with the specified font, state, surface to draw on, and the bounds to draw within.

DrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, Color, Color)

Initialise une nouvelle instance de la classe DrawItemEventArgs pour le contrôle spécifié avec la police spécifiée, l'état, la couleur de premier plan, la couleur d'arrière-plan, la surface sur laquelle dessiner et les limites à l'intérieur desquelles dessiner.Initializes a new instance of the DrawItemEventArgs class for the specified control with the specified font, state, foreground color, background color, surface to draw on, and the bounds to draw within.

Propriétés

BackColor

Obtient la couleur d'arrière-plan de l'élément qui est en train d'être dessiné.Gets the background color of the item that is being drawn.

Bounds

Obtient le rectangle qui représente les limites de l'élément qui est en train d'être dessiné.Gets the rectangle that represents the bounds of the item that is being drawn.

Font

Obtient la police assignée à l'élément qui est en train d'être dessiné.Gets the font that is assigned to the item being drawn.

ForeColor

Obtient la couleur de premier plan de l'élément qui est en train d'être dessiné.Gets the foreground color of the of the item being drawn.

Graphics

Obtient la surface graphique sur laquelle dessiner l'élément.Gets the graphics surface to draw the item on.

Index

Obtient la valeur d'index de l'élément qui est en train d'être dessiné.Gets the index value of the item that is being drawn.

State

Obtient l'état de l'élément qui est en train d'être dessiné.Gets the state of the item being drawn.

Méthodes

DrawBackground()

Dessine l'arrière-plan dans les limites spécifiées dans le constructeur DrawItemEventArgs avec la couleur appropriée.Draws the background within the bounds specified in the DrawItemEventArgs constructor and with the appropriate color.

DrawFocusRectangle()

Dessine un rectangle de focus dans les limites spécifiées dans le constructeur DrawItemEventArgs.Draws a focus rectangle within the bounds specified in the DrawItemEventArgs constructor.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi