DataGridViewBand.Selected Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets a value indicating whether the band is in a selected user interface (UI) state.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public virtual bool Selected { get; set; }

Property Value

Type: System.Boolean

true if the band is selected; otherwise, false.

Exception Condition
InvalidOperationException

The specified value when setting this property is true, but the band has not been added to a DataGridView control.

-or-

This property is being set on a shared DataGridViewRow.

This property can be set only if a DataGridView with the SelectionMode property enabled is associated with the band.

The following code example illustrates the use of this property.

void dataGridView1_ColumnHeaderMouseClick(
    object sender, DataGridViewCellMouseEventArgs e)
{
    this.dataGridView1.SelectionMode =
        DataGridViewSelectionMode.ColumnHeaderSelect;
    this.dataGridView1.Columns[e.ColumnIndex].HeaderCell
        .SortGlyphDirection = SortOrder.None;
    this.dataGridView1.Columns[e.ColumnIndex].Selected = true;
}

void dataGridView1_RowHeaderMouseClick(
    object sender, DataGridViewCellMouseEventArgs e)
{
    this.dataGridView1.SelectionMode =
        DataGridViewSelectionMode.RowHeaderSelect;
    this.dataGridView1.Rows[e.RowIndex].Selected = true;
}

.NET Framework
Available since 2.0
Return to top
Show: