DataRepeater.DrawItem - событие

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возникает, когда необходимо изобразить элемент DataRepeaterItem.

Пространство имен: Microsoft.VisualBasic.PowerPacks
Сборка: Microsoft.VisualBasic.PowerPacks.Vs (в Microsoft.VisualBasic.PowerPacks.Vs.dll)

Синтаксис

'Декларация
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 не поддерживает события.

Заметки

Это событие используется для изменения внешнего вида объектов DataRepeaterItem при их прокрутке в представлении.

Во время выполнения свойства внешнего вида задаются на основе условий прокрутки каждого элемента в представлении. Например, в приложении по планированию можно изменить цвет фона элемента для предупреждения пользователей о просроченных элементах. Если значение свойства задается в условном операторе, например If…Then, необходимо также использовать предложение Else, чтобы указать вид элемента, если условие не будет выполнено.

Дополнительные сведения об обработке событий см. в разделе Прием событий.

Примеры

Некоторые стандартные настройки для элемента управления DataRepeater включают возможности отображения строк различными цветами и изменения цвета поля на основе условия. Выполнение этих настроек показано в следующем примере. Пример предполагает наличие элемента управления DataRepeater, привязанного к таблице “Products” в базе данных 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;
    }
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.