DataRepeaterItemEventArgs, classe
Mise à jour : novembre 2007
Fournit des données pour l'événement DrawItem.
Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)
Syntaxe
Public Class DataRepeaterItemEventArgs _
Inherits EventArgs
Dim instance As DataRepeaterItemEventArgs
public class DataRepeaterItemEventArgs : EventArgs
public ref class DataRepeaterItemEventArgs : public EventArgs
public class DataRepeaterItemEventArgs extends EventArgs
Notes
Utilisez l'événement DrawItem pour modifier l'apparence des objets DataRepeaterItem au fur et à mesure qu'ils défilent dans l'affichage.
Des propriétés liées à l'apparence peuvent être définies en fonction de conditions au moment de l'exécution. Par exemple, dans le cas d'une application de planification, vous pouvez modifier la couleur d'arrière-plan d'un élément afin de prévenir les utilisateurs que la date d'échéance est dépassée. Si vous définissez une propriété dans une instruction conditionnelle, telle que If…Then, vous devez également utiliser une clause Else pour spécifier l'apparence lorsque la condition n'est pas remplie.
Exemples
L'exemple suivant montre comment utiliser le gestionnaire d'événements DrawItem pour apporter des modifications lorsqu'un élément défile dans l'affichage. Cet exemple suppose qu'il existe un contrôle DataRepeater lié à la table Products de 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.
DataRepeater1.ItemTemplate.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.
dataRepeater1.ItemTemplate.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;
}
}
Hiérarchie d'héritage
System.Object
System.EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs
Sécurité des threads
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Voir aussi
Référence
Membres DataRepeaterItemEventArgs
Microsoft.VisualBasic.PowerPacks, espace de noms
Autres ressources
Introduction au contrôle DataRepeater (Visual Studio)
Comment : modifier l'apparence d'un contrôle DataRepeater (Visual Studio)