DataGridViewComboBoxColumn.Items Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém a coleção de objetos usada como seleção nas caixas de combo.
public:
property System::Windows::Forms::DataGridViewComboBoxCell::ObjectCollection ^ Items { System::Windows::Forms::DataGridViewComboBoxCell::ObjectCollection ^ get(); };
public System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection Items { get; }
member this.Items : System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection
Public ReadOnly Property Items As DataGridViewComboBoxCell.ObjectCollection
Valor de Propriedade
Um DataGridViewComboBoxCell.ObjectCollection que representa as escolhas nas caixas de combo.
Exceções
O valor da CellTemplate propriedade é null.
Exemplos
O exemplo de código seguinte demonstra como usar a DataGridViewComboBoxColumn para ajudar na introdução de dados na TitleOfCourtesy coluna. A Items propriedade é usada para preencher a lista suspensa de caixas combo com uma seleção de títulos. Este exemplo faz parte de um exemplo mais amplo disponível no DataGridViewComboBoxColumn tópico de visão geral da aula.
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
Observações
Esta propriedade devolve o valor da Items propriedade devolvida DataGridViewComboBoxCell pela CellTemplate propriedade.
As Items propriedades ou DataSource são usadas para preencher as seleções das caixas de combo.
Se as cadeias forem adicionadas a Items, então as ValueMember propriedades e DisplayMember não precisam de ser definidas porque cada cadeia adicionada será usada tanto para valor como para exibição.
Note
DataGridViewComboBoxColumn não suporta o uso de múltiplos itens com valores de exibição idênticos.
Se a DataSource propriedade estiver definida, então Items não pode ser usada.