DataGridViewComboBoxCell.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 os objetos que representam a seleção apresentada na lista suspensa.
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.ObjectCollectionPublic Overridable ReadOnly Property Items As DataGridViewComboBoxCell.ObjectCollectionValor de Propriedade
An DataGridViewComboBoxCell.ObjectCollection contendo a seleção.
- Atributos
Exemplos
O exemplo de código seguinte demonstra a utilização da DataGridViewComboBoxColumn.Items propriedade, que é semelhante a esta propriedade. 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 permite-lhe obter uma referência à lista de itens atualmente armazenados no DataGridViewComboBoxCellarquivo . Com esta referência, pode adicionar itens, remover itens e obter uma contagem dos itens na coleção. Para mais informações sobre as tarefas que podem ser realizadas com a Items coleção, veja DataGridViewComboBoxCell.ObjectCollection.
Se as cadeias forem adicionadas a Items, então ValueMember e DisplayMember não precisam de ser definidas porque cada cadeia adicionada será usada tanto para valor como para visualização.
Note
DataGridViewComboBoxCell não suporta o uso de múltiplos itens com valores de exibição idênticos.
Se a DataSource propriedade estiver definida, então a Items propriedade não pode ser usada.
O valor formatado da célula deve ser sempre um dos valores da Items coleção, caso contrário ocorrerá um erro e o valor da célula reverterá para o primeiro item da coleção. Pode personalizar este comportamento ao lidar com os DataGridView.DataError eventos e DataGridView.CellFormatting .
Definir esta propriedade para um valor diferente do valor da propriedade da Items coluna pai forçará a linha a tornar-se não partilhada, alocando memória extra. Para obter mais informações sobre a partilha de linhas, consulte Práticas Recomendadas para Dimensionar o Controle DataGridView do Windows Forms.
