DataRepeaterItem クラス

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

更新 : 2007 年 11 月

DataRepeater コントロールにより、データを実行時に表示するために使用されます。

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

構文

'宣言
<DockingAttribute(DockingBehavior.Never)> _
Public Class DataRepeaterItem _
    Inherits Panel
'使用
Dim instance As DataRepeaterItem

[DockingAttribute(DockingBehavior.Never)]
public class DataRepeaterItem : Panel

[DockingAttribute(DockingBehavior::Never)]
public ref class DataRepeaterItem : public Panel

public class DataRepeaterItem extends Panel

解説

DataRepeater コントロールは、DataRepeaterItem オブジェクトを使用して、コントロール内の各項目をビュー内でスクロールして表示します。項目がスクロールしてビューの外に移動すると、DataRepeaterItem は無効になり、次にビューに表示される項目の新しい DataRepeaterItem に置き換わります。

各項目のレイアウトと外観は、ItemTemplate プロパティによって決定されます。各 DataRepeaterItem を表示するときに、DrawItem イベント内で外観を変更できます。

メモ :
DrawItem イベントからアクセスできる DataRepeaterItem のみを変更するようにしてください。イベントの外部で変更しようとしたり、新しい DataRepeaterItem を作成しようとしたりすると、予期しない結果になる可能性があります。

例

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