DataGridView.RowTemplate Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property RowTemplate As DataGridViewRowValor da propriedade
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.