DataRepeater.ItemTemplate プロパティ
DataRepeater のコントロールの DataRepeaterItem を表すテンプレートを取得します。
名前空間: Microsoft.VisualBasic.PowerPacks
アセンブリ: Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)
構文
'宣言
<BrowsableAttribute(False)> _
Public ReadOnly Property ItemTemplate As DataRepeaterItem
[BrowsableAttribute(false)]
public DataRepeaterItem ItemTemplate { get; }
[BrowsableAttribute(false)]
public:
property DataRepeaterItem^ ItemTemplate {
DataRepeaterItem^ get ();
}
[<BrowsableAttribute(false)>]
member ItemTemplate : DataRepeaterItem
function get ItemTemplate () : DataRepeaterItem
プロパティ値
型 : Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
DataRepeater コントロールの項目のレイアウトと外観を指定するオブジェクト。
解説
DataRepeater コントロールのすべての項目の実行時の外観を指定するプロパティを設定するに ItemTemplate のプロパティを使用します。つまり、実際に実行時に作成される DataRepeaterItem オブジェクトのプロパティの設定です。実行時に DataRepeater に表示される項目がこのオブジェクトからスクロールして表示すると同時にコピーします。
デザイン時には、コントロールを含む DataRepeater のセクションを選択すると、[プロパティ] ウィンドウに ItemTemplate のプロパティが含まれています。たとえば、Red に ItemTemplate の BackColor のプロパティを設定すると、DataRepeater のすべての項目を赤い背景色で表示されます。
実行時に、ItemTemplate のプロパティを変更すると、プロパティを設定する前に BeginResetItemTemplate のメソッドを呼び出してし、変更をコミットするに EndResetItemTemplate のメソッドを呼び出します。
または ItemTemplate のプロパティは、実行時に DataRepeaterItem のコントロールにアクセスするために使用されます。たとえば、TextBox の BackColor を取得するには IDTextBox のは、次のコードがあります :
Dim BC As Color = _
DataRepeater1.ItemTemplate.Controls(IDTextBox.Name).BackColor
color BC = dataRepeater1.ItemTemplate.Controls["IDTextBox"].BackColor;
例
DataRepeater コントロールの一般的なカスタマイズの例として、行の色を交互にする、条件に基づいてフィールドの色を変更する、などが挙げられます。このようなカスタマイズを行う方法を次の例に示します。この例では、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.
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;
}
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。
参照
関連項目
Microsoft.VisualBasic.PowerPacks 名前空間