Classe DataRepeaterItemEventArgs

Artigo
10/26/2012

Fornece dados para o evento DrawItem.

Hierarquia de herança

System.Object
System.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	determina se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
	Finalize	Permite que um objeto tentar liberar recursos e realizar outras operações de limpeza antes de ser recuperados pela coleta de lixo. (Herdado de Object.)
	GetHashCode	Serve como uma função de hash para um tipo específico. (Herdado de Object.)
	GetType	Obtém Type da instância atual. (Herdado de Object.)
	MemberwiseClone	Cria uma cópia superficial de Objectatual. (Herdado de Object.)
	ToString	Retorna uma cadeia de caracteres que representa o objeto atual. (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.