DataRepeater.DrawItem (Evento)
Se produce cuando debe dibujarse un DataRepeaterItem.
Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)
Sintaxis
'Declaración
Public Event DrawItem As DataRepeaterItemEventHandler
public event DataRepeaterItemEventHandler DrawItem
public:
event DataRepeaterItemEventHandler^ DrawItem {
void add (DataRepeaterItemEventHandler^ value);
void remove (DataRepeaterItemEventHandler^ value);
}
member DrawItem : IEvent<DataRepeaterItemEventHandler,
DataRepeaterItemEventArgs>
JScript no admite eventos.
Comentarios
Utilice este evento para cambiar la apariencia del DataRepeaterItem objetos que se desplazan en la vista.
En tiempo de ejecución, las propiedades relacionadas con la apariencia pueden establecerse en función de condiciones como cada elemento se desplaza en la vista. Por ejemplo, en una aplicación de programación, puede cambiar el color de fondo de un elemento para advertir a los usuarios cuando un elemento está vencido. Si se establece una propiedad en una instrucción condicional como If…Then, también debe utilizar un Else cláusula para especificar el aspecto cuando no se cumple la condición.
Para obtener más información acerca de cómo controlar eventos, vea Controlar y provocar eventos.
Ejemplos
Algunas personalizaciones comunes para la DataRepeater control incluyen mostrar las filas en colores alternos y cambiar el color de un campo según una condición. En el ejemplo siguiente se muestra cómo realizar estas personalizaciones. En este ejemplo se supone que tiene un DataRepeater control que está 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 de .NET Framework
- 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)