DataRepeater.DrawItem (Evento)
Actualización: noviembre 2007
Se produce cuando se debe dibujar un DataRepeaterItem.
Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)
Sintaxis
Public Event DrawItem As DataRepeaterItemEventHandler
Dim instance As DataRepeater
Dim handler As DataRepeaterItemEventHandler
AddHandler instance.DrawItem, handler
public event DataRepeaterItemEventHandler DrawItem
public:
event DataRepeaterItemEventHandler^ DrawItem {
void add (DataRepeaterItemEventHandler^ value);
void remove (DataRepeaterItemEventHandler^ value);
}
JScript no admite eventos.
Comentarios
Utilice este evento para cambiar la apariencia de los objetos DataRepeaterItem cuando se desplacen en la vista.
En tiempo de ejecución, se pueden establecer propiedades relacionadas con la apariencia basándose en condiciones cuando los elementos se van desplazando en la vista. 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 deberá usar una cláusula Else para especificar la apariencia en caso de que no se cumpla la condición.
Para obtener más información sobre cómo controlar los eventos, vea Utilizar eventos.
Ejemplos
Entre las personalizaciones más comunes del control DataRepeater están la de mostrar las filas en colores alternos y la de cambiar el color de un campo en función de una condición. En el ejemplo siguiente se muestra cómo llevar a cabo estas personalizaciones. 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.
DataRepeater1.ItemTemplate.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.
dataRepeater1.ItemTemplate.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;
}
}
Permisos
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.
Vea también
Referencia
Microsoft.VisualBasic.PowerPacks (Espacio de nombres)
Otros recursos
Introducción al control DataRepeater (Visual Studio)
Cómo: Cambiar la apariencia de un control DataRepeater (Visual Studio)