DataGridView.RowTemplate 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 ou define a linha que representa o modelo para todas as linhas do controlo.
public:
property System::Windows::Forms::DataGridViewRow ^ RowTemplate { System::Windows::Forms::DataGridViewRow ^ get(); void set(System::Windows::Forms::DataGridViewRow ^ value); };[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewRow RowTemplate { get; set; }[<System.ComponentModel.Browsable(true)>]
member this.RowTemplate : System.Windows.Forms.DataGridViewRow with get, setPublic Property RowTemplate As DataGridViewRowValor de Propriedade
A DataGridViewRow representa o modelo de linha.
- Atributos
Exceções
A linha especificada ao definir esta propriedade tem a DataGridView sua propriedade definida.
Exemplos
O exemplo de código seguinte ilustra como usar o modelo de linha para especificar uma altura inicial de linha e uma altura mínima de linha.
DataGridViewRow^ row = this->dataGridView1->RowTemplate;
row->DefaultCellStyle->BackColor = Color::Bisque;
row->Height = 35;
row->MinimumHeight = 20;
DataGridViewRow row = this.dataGridView1.RowTemplate;
row.DefaultCellStyle.BackColor = Color.Bisque;
row.Height = 35;
row.MinimumHeight = 20;
With Me.dataGridView1.RowTemplate
.DefaultCellStyle.BackColor = Color.Bisque
.Height = 35
.MinimumHeight = 20
End With
Observações
Por vezes, queres um controlo maior sobre a aparência das DataGridView linhas do que o proporcionado pelas várias DataGridView propriedades do estilo de célula. A RowTemplate propriedade permite-lhe criar e inicializar um DataGridViewRow para usar como modelo por todas as linhas, incluindo a linha para novos registos se AllowUserToAddRows for true.
Isto é útil quando defines valores por defeito para propriedades como a altura das linhas. Por exemplo, pode querer aumentar a altura padrão da linha para criar espaço extra por baixo do conteúdo normal das células para mostrar conteúdos que abrangem várias colunas.
Definir o modelo de linha é necessário quando dados externos são exibidos usando tipos personalizados derivados da DataGridViewRow classe. Com controlos não vinculados DataGridView , pode preencher programaticamente a Rows coleção com instâncias do seu tipo de linha personalizado. Ao mostrar dados externos, no entanto, as linhas são geradas automaticamente, mas baseiam-se no modelo de linha, que pode definir para uma instância do seu tipo de linha personalizado.
Se esta propriedade não tiver sido definida na primeira vez que recupera o seu valor, uma nova DataGridViewRow é criada e devolvida.