DataGridViewComboBoxCell.Items Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera obiekty reprezentujące zaznaczenie wyświetlane na liście rozwijanej.
public:
virtual property System::Windows::Forms::DataGridViewComboBoxCell::ObjectCollection ^ Items { System::Windows::Forms::DataGridViewComboBoxCell::ObjectCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection Items { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Items : System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection
Public Overridable ReadOnly Property Items As DataGridViewComboBoxCell.ObjectCollection
Wartość właściwości
Element DataGridViewComboBoxCell.ObjectCollection zawierający zaznaczenie.
- Atrybuty
Przykłady
W poniższym przykładzie kodu pokazano użycie DataGridViewComboBoxColumn.Items właściwości, która jest podobna do tej właściwości. Ten przykład jest częścią większego przykładu dostępnego w temacie DataGridViewComboBoxColumn przeglądu klasy.
private:
void SetAlternateChoicesUsingItems(
DataGridViewComboBoxColumn^ comboboxColumn)
{
comboboxColumn->Items->AddRange("Mr.", "Ms.", "Mrs.", "Dr.");
}
private:
DataGridViewComboBoxColumn^ CreateComboBoxColumn()
{
DataGridViewComboBoxColumn^ column =
gcnew DataGridViewComboBoxColumn();
{
column->DataPropertyName = ColumnName::TitleOfCourtesy.ToString();
column->HeaderText = ColumnName::TitleOfCourtesy.ToString();
column->DropDownWidth = 160;
column->Width = 90;
column->MaxDropDownItems = 3;
column->FlatStyle = FlatStyle::Flat;
}
return column;
}
private static void SetAlternateChoicesUsingItems(
DataGridViewComboBoxColumn comboboxColumn)
{
comboboxColumn.Items.AddRange("Mr.", "Ms.", "Mrs.", "Dr.");
}
private DataGridViewComboBoxColumn CreateComboBoxColumn()
{
DataGridViewComboBoxColumn column =
new DataGridViewComboBoxColumn();
{
column.DataPropertyName = ColumnName.TitleOfCourtesy.ToString();
column.HeaderText = ColumnName.TitleOfCourtesy.ToString();
column.DropDownWidth = 160;
column.Width = 90;
column.MaxDropDownItems = 3;
column.FlatStyle = FlatStyle.Flat;
}
return column;
}
Private Shared Sub SetAlternateChoicesUsingItems( _
ByVal comboboxColumn As DataGridViewComboBoxColumn)
comboboxColumn.Items.AddRange("Mr.", "Ms.", "Mrs.", "Dr.")
End Sub
Private Function CreateComboBoxColumn() _
As DataGridViewComboBoxColumn
Dim column As New DataGridViewComboBoxColumn()
With column
.DataPropertyName = ColumnName.TitleOfCourtesy.ToString()
.HeaderText = ColumnName.TitleOfCourtesy.ToString()
.DropDownWidth = 160
.Width = 90
.MaxDropDownItems = 3
.FlatStyle = FlatStyle.Flat
End With
Return column
End Function
Uwagi
Ta właściwość umożliwia uzyskanie odwołania do listy elementów, które są obecnie przechowywane w obiekcie DataGridViewComboBoxCell. Dzięki temu odwołaniu można dodawać elementy, usuwać elementy i uzyskiwać liczbę elementów w kolekcji. Aby uzyskać więcej informacji na temat zadań, które można wykonać za pomocą kolekcji Items , zobacz DataGridViewComboBoxCell.ObjectCollection.
Jeśli ciągi są dodawane do Itemselementu , ValueMember i DisplayMember nie trzeba ich ustawiać, ponieważ każdy dodany ciąg będzie używany zarówno dla wartości, jak i wyświetlania.
Uwaga / Notatka
DataGridViewComboBoxCell nie obsługuje użycia wielu elementów z identycznymi wartościami wyświetlania.
Jeśli właściwość jest ustawiona DataSource , Items nie można użyć właściwości .
Sformatowana wartość komórki musi być zawsze jedną z wartości w Items kolekcji lub wystąpi błąd, a wartość komórki zostanie przywrócona do pierwszego elementu w kolekcji. To zachowanie można dostosować, obsługując zdarzenia DataGridView.DataError i .DataGridView.CellFormatting
Ustawienie tej właściwości na wartość inną niż wartość właściwości kolumny nadrzędnej Items wymusi, aby wiersz stał się nieudostępniany, przydzielając dodatkową pamięć. Aby uzyskać więcej informacji na temat udostępniania wierszy, zobacz Best Practices for Scaling the Windows Forms DataGridView Control (Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView formularzy systemu Windows).