Classe DataRepeaterItemEventArgs

Articolo
05/16/2015

Fornisce dati per l'evento DrawItem.

Gerarchia di ereditarietà

Object
EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

'Dichiarazione
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

Il tipo DataRepeaterItemEventArgs espone i seguenti membri.

Costruttori

	Nome	Descrizione
	DataRepeaterItemEventArgs	Inizializza una nuova istanza della classe DataRepeaterItemEventArgs.

In alto

Proprietà

	Nome	Descrizione
	DataRepeaterItem	Ottiene un DataRepeaterItem che fornisce i dati per l'evento DrawItem di un controllo DataRepeater

In alto

Metodi

	Nome	Descrizione
	Equals	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
	Finalize	Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection. (Ereditato da Object)
	GetHashCode	Funge da funzione hash predefinita. (Ereditato da Object)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	MemberwiseClone	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Note

Utilizzare l'evento di DrawItem per modificare l'aspetto degli oggetti di DataRepeaterItem come vengono scorsi nella visualizzazione.

In fase di esecuzione, le proprietà correlate all'aspetto possono essere impostate in base a condizioni. Ad esempio, in un'applicazione di pianificazione, è possibile modificare il colore di sfondo di un elemento per avvisare gli utenti quando un elemento è scaduto. Se si imposta una proprietà in un'istruzione condizionale come If…Then, è necessario utilizzare anche una clausola di Else per specificare l'aspetto quando la condizione non viene soddisfatta.

Esempi

Nell'esempio seguente viene illustrato come utilizzare il gestore eventi di DrawItem per apportare modifiche quando un elemento viene scorso nella visualizzazione. In questo esempio si suppone di disporre di un controllo DataRepeater associato alla tabella Products nel database 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;
    }
}