DataGridView.DefaultValuesNeeded Evento
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.
Ocorre quando o utilizador insere a linha para novos registos para que esta possa ser preenchida com valores predefinidos.
public:
event System::Windows::Forms::DataGridViewRowEventHandler ^ DefaultValuesNeeded;public event System.Windows.Forms.DataGridViewRowEventHandler DefaultValuesNeeded;member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler Tipo de Evento
Exemplos
O exemplo de código seguinte ilustra como este evento pode ser tratado. No exemplo, as células das colunas dadas são preenchidas com valores padrão. Para a CustomerID coluna, o valor é recuperado de um método separado (não implementado) que gera um ID de cliente único.
Para executar este exemplo, substitua os nomes das colunas pelos nomes dos objetos coluna de um controlo real DataGridView e forneça os valores padrão apropriados. Ao especificar colunas pelo nome, deve usar o nome do objeto coluna e não o texto do cabeçalho da coluna.
private void dataGridView1_DefaultValuesNeeded(object sender,
System.Windows.Forms.DataGridViewRowEventArgs e)
{
e.Row.Cells["Region"].Value = "WA";
e.Row.Cells["City"].Value = "Redmond";
e.Row.Cells["PostalCode"].Value = "98052-6399";
e.Row.Cells["Country"].Value = "USA";
e.Row.Cells["CustomerID"].Value = NewCustomerId();
}
Private Sub dataGridView1_DefaultValuesNeeded(ByVal sender As Object, _
ByVal e As System.Windows.Forms.DataGridViewRowEventArgs) _
Handles dataGridView1.DefaultValuesNeeded
With e.Row
.Cells("Region").Value = "WA"
.Cells("City").Value = "Redmond"
.Cells("PostalCode").Value = "98052-6399"
.Cells("Country").Value = "USA"
.Cells("CustomerID").Value = NewCustomerId()
End With
End Sub
Observações
Este evento permite-lhe preencher a linha para novos registos quando o utilizador entra na linha. Os valores iniciais para a linha provêm da DefaultNewRowValue propriedade de devolvida DataGridViewCell pela propriedade de CellTemplate cada coluna.
No modo de data bound, todos os valores das células das colunas de data bound são armazenados na fonte de dados externa. Quando o utilizador entra na linha para novos registos, uma nova linha é criada na fonte de dados antes do DefaultValuesNeeded evento ocorrer. Quando preenche a DataGridViewRowEventArgs.Row propriedade no seu gestor de eventos, os valores são adicionados diretamente à fonte de dados.
No modo virtual, após este evento ocorrer, o CellValuePushed evento ocorre para cada célula da nova linha para que possa armazenar os valores predefinidos no seu armazenamento de dados personalizado. Depois, o CellValueNeeded evento ocorre para cada célula da nova linha, recuperando os valores que guardaste no CellValuePushed evento, que são então exibidos.
Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.