DataGridViewBand.Tag プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
バンドに関連付けられているデータを含むオブジェクトを取得または設定します。
public:
property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };[System.ComponentModel.Browsable(false)]
public object Tag { get; set; }[System.ComponentModel.Browsable(false)]
public object? Tag { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.Tag : obj with get, setPublic Property Tag As Objectプロパティ値
バンドに関連付けられた情報を含む Object。 既定値は、null です。
- 属性
例
次のコード例では、プロパティを Tag 使用して、プロパティを設定するために後で取得される色を BackColor 格納します。
void PostRowCreation()
{
SetBandColor( dataGridView->Columns[ 0 ], Color::CadetBlue );
SetBandColor( dataGridView->Rows[ 1 ], Color::Coral );
SetBandColor( dataGridView->Columns[ 2 ], Color::DodgerBlue );
}
void SetBandColor( DataGridViewBand^ band, Color color )
{
band->Tag = color;
}
// Color the bands by the value stored in their tag.
void Button9_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
IEnumerator^ myEnum1 = dataGridView->Columns->GetEnumerator();
while ( myEnum1->MoveNext() )
{
DataGridViewBand^ band = static_cast<DataGridViewBand^>(myEnum1->Current);
if ( band->Tag != nullptr )
{
band->DefaultCellStyle->BackColor = *dynamic_cast<Color^>(band->Tag);
}
}
IEnumerator^ myEnum2 = safe_cast<IEnumerable^>(dataGridView->Rows)->GetEnumerator();
while ( myEnum2->MoveNext() )
{
DataGridViewBand^ band = safe_cast<DataGridViewBand^>(myEnum2->Current);
if ( band->Tag != nullptr )
{
band->DefaultCellStyle->BackColor = *dynamic_cast<Color^>(band->Tag);
}
}
}
private void PostRowCreation()
{
SetBandColor(dataGridView.Columns[0], Color.CadetBlue);
SetBandColor(dataGridView.Rows[1], Color.Coral);
SetBandColor(dataGridView.Columns[2], Color.DodgerBlue);
}
private static void SetBandColor(DataGridViewBand band, Color color)
{
band.Tag = color;
}
// Color the bands by the value stored in their tag.
private void Button9_Click(object sender, System.EventArgs e)
{
foreach (DataGridViewBand band in dataGridView.Columns)
{
if (band.Tag != null)
{
band.DefaultCellStyle.BackColor = (Color)band.Tag;
}
}
foreach (DataGridViewBand band in dataGridView.Rows)
{
if (band.Tag != null)
{
band.DefaultCellStyle.BackColor = (Color)band.Tag;
}
}
}
Private Sub PostRowCreation()
SetBandColor(dataGridView.Columns(0), Color.CadetBlue)
SetBandColor(dataGridView.Rows(1), Color.Coral)
SetBandColor(dataGridView.Columns(2), Color.DodgerBlue)
End Sub
Private Shared Sub SetBandColor(ByVal band As DataGridViewBand, _
ByVal color As Color)
band.Tag = color
End Sub
' Color the bands by the value stored in their tag.
Private Sub Button9_Click(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button9.Click
For Each band As DataGridViewBand In dataGridView.Columns
If band.Tag IsNot Nothing Then
band.DefaultCellStyle.BackColor = _
CType(band.Tag, Color)
End If
Next
For Each band As DataGridViewBand In dataGridView.Rows
If band.Tag IsNot Nothing Then
band.DefaultCellStyle.BackColor = _
CType(band.Tag, Color)
End If
Next
End Sub
注釈
このプロパティには Tag 、バンドに関連付ける任意のオブジェクトを格納できます。 このプロパティは、通常、文字列名、一意識別子 (例: a)、 Guidまたはデータベース内のバンドのデータのインデックスなどの識別情報を格納するために使用されます。