DataRepeater.DrawItem, événement

Article
05/16/2015

Se produit lorsqu'un DataRepeaterItem doit être dessiné.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
Public Event DrawItem As DataRepeaterItemEventHandler

public event DataRepeaterItemEventHandler DrawItem

public:
 event DataRepeaterItemEventHandler^ DrawItem {
    void add (DataRepeaterItemEventHandler^ value);
    void remove (DataRepeaterItemEventHandler^ value);
}

member DrawItem : IEvent<DataRepeaterItemEventHandler,
    DataRepeaterItemEventArgs>

JScript ne prend pas en charge les événements.

Notes

Utilisez cet événement pour modifier l'apparence de DataRepeaterItem comme elles défilent dans l'affichage des objets.

Au moment de l'exécution, relatives à l'apparence des propriétés peuvent être définies en fonction des conditions que chaque élément est affiché. Par exemple, dans une application de planification, vous pouvez modifier la couleur d'arrière-plan d'un élément pour avertir les utilisateurs lorsqu'un élément est arriéré. Si vous définissez une propriété dans une instruction conditionnelle telle que If…Then, vous devez également utiliser un Else clause pour spécifier l'apparence lorsque la condition n'est pas remplie.

Pour plus d'informations sur la façon de gérer les événements, consultez Gestion et déclenchement d'événements.

Exemples

Certaines personnalisations courantes du DataRepeater contrôle comprennent l'affichage des lignes dans des couleurs alternées et modifier la couleur d'un champ en fonction d'une condition. L'exemple suivant montre comment effectuer ces personnalisations. Cet exemple suppose que vous avez un DataRepeater contrôle qui est lié à la table Products dans la base de données Northwind.

Private Sub DataRepeater1_DrawItem(
    ByVal sender As Object, 
    ByVal e As Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs
  ) Handles DataRepeater1.DrawItem

    ' Alternate the back color. 
    If (e.DataRepeaterItem.ItemIndex Mod 2) <> 0 Then 
        ' Apply the secondary back color.
        e.DataRepeaterItem.BackColor = Color.AliceBlue
    Else 
        ' Apply the default back color.
        e.DataRepeaterItem.BackColor = Color.White
    End If 
    ' Change the color of out-of-stock items to red. 
    If e.DataRepeaterItem.Controls(
          UnitsInStockTextBox.Name).Text < 1 Then

        e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name). 
         BackColor = Color.Red
    Else
        e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name). 
         BackColor = Color.White
    End If 
End Sub

private void dataRepeater1_DrawItem(object sender, 
    Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs e)
{
    // Alternate the back color. 
    if ((e.DataRepeaterItem.ItemIndex % 2) != 0)
    // Apply the secondary back color.
    {
        e.DataRepeaterItem.BackColor = Color.AliceBlue;
    }
    else
    {
        // Apply the default back color.
        e.DataRepeaterItem.BackColor = Color.White;
    }
    // Change the color of out-of-stock items to red. 
    if (e.DataRepeaterItem.Controls["unitsInStockTextBox"].Text == "0")
    {
        e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.Red;
    }
    else
    {
        e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.White;
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.