DataRepeaterItemEventArgs (Clase)

Artículo
05/17/2015

Proporciona datos para el evento DrawItem.

Jerarquía de herencia

Object
EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
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

El tipo DataRepeaterItemEventArgs expone los siguientes miembros.

Constructores

	Nombre	Descripción
	DataRepeaterItemEventArgs	Inicializa una nueva instancia de la clase DataRepeaterItemEventArgs.

Arriba

Propiedades

	Nombre	Descripción
	DataRepeaterItem	Obtiene un objeto DataRepeaterItem que proporciona los datos para el evento DrawItem de un control DataRepeater.

Arriba

Métodos

	Nombre	Descripción
	Equals	Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetHashCode	Sirve como la función hash predeterminada. (Se hereda de Object).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	MemberwiseClone	Crea una copia superficial del Object actual. (Se hereda de Object).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Comentarios

Utilice el evento de DrawItem para cambiar la apariencia de los objetos de DataRepeaterItem como se desplazan en la vista.

En tiempo de ejecución, las propiedades relacionadas con la apariencia se pueden establecer basándose en condiciones. Por ejemplo, en una aplicación de programación, se puede cambiar el color de fondo de un elemento para advertir a los usuarios del vencimiento de un elemento. Si establece una propiedad en una instrucción condicional como If…Then, también debe utilizar una cláusula de Else para especificar el aspecto cuando la condición no se cumple.

Ejemplos

El ejemplo siguiente muestra cómo usar el controlador de eventos de DrawItem para realizar cambios cuando un elemento se desplaza en la vista. En este ejemplo, se supone que tiene un control DataRepeater enlazado a la tabla Products de la base de datos 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;
    }
}

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.