DataRepeaterItemEventArgs.DataRepeaterItem プロパティ

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

DataRepeater コントロールの DrawItem イベントのデータを提供する DataRepeaterItem を取得します。

名前空間 : Microsoft.VisualBasic.PowerPacks
アセンブリ : Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
Public ReadOnly Property DataRepeaterItem As DataRepeaterItem
'使用
Dim instance As DataRepeaterItemEventArgs
Dim value As DataRepeaterItem

value = instance.DataRepeaterItem

public DataRepeaterItem DataRepeaterItem { get; }

public:
property DataRepeaterItem^ DataRepeaterItem {
    DataRepeaterItem^ get ();
}

public function get DataRepeaterItem () : DataRepeaterItem

プロパティ値

型 : Microsoft.VisualBasic.PowerPacks.DataRepeaterItem

データを格納している項目。これは、DataRepeater コントロールの ItemTemplate プロパティに基づきます。

解説

DrawItem イベントを使用して、DataRepeaterItem オブジェクトをスクロールして表示するときの外観を変更します。

外観に関連するプロパティは、実行時に、条件に基づいて設定できます。たとえば、スケジュール管理用のアプリケーションでは、項目の背景色を変更して、期限切れの項目を警告できます。If…Then などの条件付きステートメントでプロパティを設定する場合は、Else 句も使用して、条件が満たされない場合の外観を指定する必要があります。

例

項目をスクロールして表示するときに DrawItem イベントハンドラを使用して変更を加える方法を次の例に示します。この例では、Northwind データベースの Products テーブルにバインドされた DataRepeater コントロールがあることを前提としています。

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;
    }
}