DataRepeaterItemEventArgs, classe

Article
11/15/2012

Fournit des données pour l'événement DrawItem.

Hiérarchie d'héritage

System.Object
System.EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs

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

Syntaxe

'Déclaration
Public Class DataRepeaterItemEventArgs _
    Inherits EventArgs

public class DataRepeaterItemEventArgs : EventArgs

public ref class DataRepeaterItemEventArgs : public EventArgs

type DataRepeaterItemEventArgs =  
    class
        inherit EventArgs
    end

public class DataRepeaterItemEventArgs extends EventArgs

Le type DataRepeaterItemEventArgs expose les membres suivants.

Constructeurs

	Nom	Description
	DataRepeaterItemEventArgs	Initialise une nouvelle instance de la classe DataRepeaterItemEventArgs.

Début

Propriétés

	Nom	Description
	DataRepeaterItem	Obtient DataRepeaterItem qui fournit les données pour l'événement d'DrawItem d'un contrôle d'DataRepeater

Début

Méthodes

	Nom	Description
	Equals	Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Notes

Utilisez l'événement d'DrawItem pour modifier l'apparence des objets d'DataRepeaterItem comme ils sont faits défiler dans la vue.

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éfini une propriété dans une instruction conditionnelle telle qu'If…Then, vous devez également utiliser une clause d'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 d'DrawItem pour apporter des modifications lorsqu'un élément est fait défiler dans la vue.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.
        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é 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.