Partilhar via


DataGridView.RowTemplate Propriedade

Definição

Obtém ou define a linha que representa o modelo de todas as linhas no controle.

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, set
Public Property RowTemplate As DataGridViewRow

Valor da propriedade

DataGridViewRow

Um DataGridViewRow que representa o modelo da linha.

Atributos

Exceções

A linha especificada ao definir essa propriedade tem sua propriedade DataGridView definida.

Exemplos

O exemplo de código a seguir ilustra como usar o modelo de linha para especificar uma altura inicial da linha e uma altura mínima da 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

Comentários

Às vezes, você deseja maior controle sobre a aparência de DataGridView linhas do que o fornecido pelas várias DataGridView propriedades de estilo de célula. A RowTemplate propriedade permite criar e inicializar um DataGridViewRow para uso como modelo por todas as linhas, incluindo a linha para novos registros, se AllowUserToAddRows for true.

Isso é útil quando você está definindo valores padrão para propriedades como a altura da linha. Por exemplo, talvez você queira aumentar a altura da linha padrão para fornecer espaço extra abaixo do conteúdo de célula comum para exibir conteúdo que abrange várias colunas.

Definir o modelo de linha é necessário quando dados externos são exibidos usando tipos personalizados derivados da DataGridViewRow classe. Com controles não associados DataGridView , você pode preencher programaticamente a Rows coleção com instâncias do tipo de linha personalizado. No entanto, ao exibir dados externos, as linhas são geradas automaticamente, mas são baseadas no modelo de linha, que pode ser definido como uma instância do tipo de linha personalizado.

Se essa propriedade não tiver sido definida na primeira vez que você recuperar seu valor, uma nova DataGridViewRow será criada e retornada.

Aplica-se a

Confira também