DataRepeater.DrawItem 事件

發行項
05/16/2015

發生時DataRepeaterItem必須繪製。

命名空間： Microsoft.VisualBasic.PowerPacks
組件： Microsoft.VisualBasic.PowerPacks.Vs (在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中)

語法

'宣告
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 不支援事件。

備註

使用這個事件來變更的外觀DataRepeaterItem它們會捲動到檢視物件。

在執行階段，外觀相關的屬性可以設定根據條件為每個項目捲動到檢視。比方說，在排程的應用程式中，您可能會變更項目來警告使用者，當項目過期時的背景色彩。 If you set a property in a conditional statement such as If…Then, you must also use an Else clause to specify the appearance when the condition is not met.

如需如何處理事件的詳細資訊，請參閱處理和引發事件。

範例

一些常見的自訂DataRepeater控制項包含替代色彩和變更色彩根據條件的欄位中顯示資料列。下列範例示範如何執行這些自訂項目。這個範例假設您有DataRepeater繫結至 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;
    }
}