Classe DataRepeaterItemEventArgs

Artigo
05/17/2015

Fornece dados para o evento DrawItem.

Hierarquia de herança

Object
EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
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

O tipo DataRepeaterItemEventArgs expõe os membros a seguir.

Construtores

	Nome	Descrição
	DataRepeaterItemEventArgs	Inicializa uma nova instância da classe DataRepeaterItemEventArgs.

Superior

Propriedades

	Nome	Descrição
	DataRepeaterItem	Obtém um DataRepeaterItem que fornece os dados para o DrawItem o evento de um DataRepeater controle

Superior

Métodos

	Nome	Descrição
	Equals	Determines whether the specified object is equal to the current object. (Herdado de Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Herdado de Object.)
	GetHashCode	Serves as the default hash function. (Herdado de Object.)
	GetType	Gets the Type of the current instance. (Herdado de Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Herdado de Object.)
	ToString	Returns a string that represents the current object. (Herdado de Object.)

Superior

Comentários

Use o DrawItem evento para alterar a aparência de DataRepeaterItem objetos como eles são colocados na exibição.

Em tempo de execução, propriedades relacionadas à aparência podem ser definidas com base nas condições. Por exemplo, em um aplicativo de agendamento, você pode alterar a cor de plano de fundo de um item para avisar os usuários quando um item está vencido. Se você definir uma propriedade em uma instrução condicional, tais como If…Then, você também deve usar um Else cláusula para especificar a aparência quando a condição não for atendida.

Exemplos

O exemplo a seguir demonstra como usar o DrawItem o manipulador de eventos para fazer alterações quando um item é colocado na exibição. Este exemplo presume que você tenha um DataRepeater controle está acoplado à tabela Produtos no banco de dados 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;
    }
}

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.