DataGridViewColumnCollection Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewColumnCollection.cs

Představuje kolekci DataGridViewColumn objektů v ovládacím DataGridView prvku.

public ref class DataGridViewColumnCollection : System::Windows::Forms::BaseCollection, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class DataGridViewColumnCollection : System.Windows.Forms.BaseCollection, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type DataGridViewColumnCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable

Public Class DataGridViewColumnCollection
Inherits BaseCollection
Implements IList

Dědičnost

Object

MarshalByRefObject

BaseCollection

DataGridViewColumnCollection

Atributy

ListBindableAttribute

Implementuje

ICollection IEnumerable IList

Příklady

Následující příklad kódu znázorňuje použití tohoto typu.

private DataGridView dataGridView1 = new DataGridView();

private void AddColorColumn()
{
    DataGridViewComboBoxColumn comboBoxColumn =
        new DataGridViewComboBoxColumn();
    comboBoxColumn.Items.AddRange(
        Color.Red, Color.Yellow, Color.Green, Color.Blue);
    comboBoxColumn.ValueType = typeof(Color);
    dataGridView1.Columns.Add(comboBoxColumn);
    dataGridView1.EditingControlShowing +=
        new DataGridViewEditingControlShowingEventHandler(
        dataGridView1_EditingControlShowing);
}

private void dataGridView1_EditingControlShowing(object sender,
    DataGridViewEditingControlShowingEventArgs e)
{
    ComboBox combo = e.Control as ComboBox;
    if (combo != null)
    {
        // Remove an existing event-handler, if present, to avoid 
        // adding multiple handlers when the editing control is reused.
        combo.SelectedIndexChanged -=
            new EventHandler(ComboBox_SelectedIndexChanged);

        // Add the event handler. 
        combo.SelectedIndexChanged +=
            new EventHandler(ComboBox_SelectedIndexChanged);
    }
}

private void ComboBox_SelectedIndexChanged(object sender, EventArgs e)
{
    ((ComboBox)sender).BackColor = (Color)((ComboBox)sender).SelectedItem;
}

Private WithEvents dataGridView1 As New DataGridView()

Private Sub AddColorColumn()

    Dim comboBoxColumn As New DataGridViewComboBoxColumn()
    comboBoxColumn.Items.AddRange( _
        Color.Red, Color.Yellow, Color.Green, Color.Blue)
    comboBoxColumn.ValueType = GetType(Color)
    dataGridView1.Columns.Add(comboBoxColumn)

End Sub

Private Sub dataGridView1_EditingControlShowing(ByVal sender As Object, _
    ByVal e As DataGridViewEditingControlShowingEventArgs) _
    Handles dataGridView1.EditingControlShowing

    Dim combo As ComboBox = CType(e.Control, ComboBox)
    If (combo IsNot Nothing) Then

        ' Remove an existing event-handler, if present, to avoid 
        ' adding multiple handlers when the editing control is reused.
        RemoveHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

        ' Add the event handler. 
        AddHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

    End If

End Sub

Private Sub ComboBox_SelectedIndexChanged( _
    ByVal sender As Object, ByVal e As EventArgs)

    Dim comboBox1 As ComboBox = CType(sender, ComboBox)
    comboBox1.BackColor = _
        CType(CType(sender, ComboBox).SelectedItem, Color)

End Sub

Poznámky

Instanci této třídy můžete načíst prostřednictvím Columns vlastnosti DataGridView ovládacího prvku. Kolekce udržuje odkaz na ovládací prvek prostřednictvím DataGridView vlastnosti.

Konstruktory

Name	Description
DataGridViewColumnCollection(DataGridView)	Inicializuje novou instanci DataGridViewColumnCollection třídy pro danou DataGridView.

Vlastnosti

Name	Description
Count	Získá celkový počet prvků v kolekci. (Zděděno od BaseCollection)
DataGridView	DataGridView Získá, na kterém kolekce provádí operace související se sloupci.
IsReadOnly	Získá hodnotu určující, zda kolekce je jen pro čtení. (Zděděno od BaseCollection)
IsSynchronized	Získá hodnotu označující, zda je přístup k sadě ICollection synchronizován. (Zděděno od BaseCollection)
Item[Int32]	Získá nebo nastaví sloupec v daném indexu v kolekci.
Item[String]	Získá nebo nastaví sloupec daného názvu v kolekci.
List	Získá seznam prvků obsažených BaseCollection v instanci.
SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k BaseCollection. (Zděděno od BaseCollection)

Metody

Name	Description
Add(DataGridViewColumn)	Přidá daný sloupec do kolekce.
Add(String, String)	DataGridViewTextBoxColumn Přidá do kolekce text záhlaví se zadaným názvem sloupce a záhlavím sloupce.
AddRange(DataGridViewColumn[])	Přidá do kolekce oblast sloupců.
Clear()	Vymaže kolekci.
Contains(DataGridViewColumn)	Určuje, zda kolekce obsahuje daný sloupec.
Contains(String)	Určuje, zda kolekce obsahuje sloupec, na který odkazuje daný název.
CopyTo(Array, Int32)	Zkopíruje všechny prvky aktuálního jednorozměrného Array do zadaného jednorozměrného Array indexu počínaje zadaným cílovým Array indexem. (Zděděno od BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Zkopíruje položky z kolekce do daného pole.
GetColumnCount(DataGridViewElementStates)	Vrátí počet sloupců, které splňují dané požadavky filtru.
GetColumnsWidth(DataGridViewElementStates)	Vrátí šířku v pixelech potřebnou k zobrazení všech sloupců, které splňují dané požadavky filtru.
GetEnumerator()	Získá objekt, který umožňuje iterace prostřednictvím členů kolekce. (Zděděno od BaseCollection)
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Vrátí první sloupec v pořadí zobrazení, který splňuje dané požadavky filtru zahrnutí a filtru vyloučení.
GetFirstColumn(DataGridViewElementStates)	Vrátí první sloupec v pořadí zobrazení, který splňuje dané požadavky filtru zahrnutí.
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Vrátí poslední sloupec v pořadí zobrazení, které splňuje dané požadavky filtru.
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Získá první sloupec za daným sloupcem v pořadí zobrazení, který splňuje dané požadavky filtru.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Získá poslední sloupec před daným sloupcem v pořadí zobrazení, které splňuje dané požadavky filtru.
IndexOf(DataGridViewColumn)	Získá index dané DataGridViewColumn v kolekci.
Insert(Int32, DataGridViewColumn)	Vloží sloupec na daný index v kolekci.
OnCollectionChanged(CollectionChangeEventArgs)	CollectionChanged Vyvolá událost.
Remove(DataGridViewColumn)	Odebere zadaný sloupec z kolekce.
Remove(String)	Odebere sloupec se zadaným názvem z kolekce.
RemoveAt(Int32)	Odebere sloupec v daném indexu v kolekci.

Událost

Name	Description
CollectionChanged	Nastane, když se kolekce změní.

Explicitní implementace rozhraní

Name	Description
ICollection.CopyTo(Array, Int32)	Zkopíruje celý obsah kolekce do kompatibilního jednorozměrného Array, počínaje zadaným indexem cílového pole.
ICollection.Count	Získá počet prvků v kolekci.
ICollection.IsSynchronized	Získá hodnotu určující, zda je přístup ke kolekci synchronizován.
ICollection.SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k kolekci.
IEnumerable.GetEnumerator()	Vrátí enumerátor, který prochází kolekcí.
IList.Add(Object)	Přidá objekt na konec kolekce.
IList.Clear()	Odebere všechny prvky z kolekce.
IList.Contains(Object)	Určuje, zda je objekt v kolekci.
IList.IndexOf(Object)	Určuje index konkrétní položky v kolekci.
IList.Insert(Int32, Object)	Vloží prvek do kolekce v zadaném indexu.
IList.IsFixedSize	Získá hodnotu určující, zda kolekce má pevnou velikost.
IList.IsReadOnly	Získá hodnotu určující, zda kolekce je jen pro čtení.
IList.Item[Int32]	Získá nebo nastaví prvek v zadaném indexu.
IList.Remove(Object)	Odebere první výskyt zadaného objektu z kolekce.
IList.RemoveAt(Int32)	Odebere prvek se zadaným indexem z kolekce.

Viz také

• DataGridView
• Columns
• DataGridViewColumn