DataGridView.RowTemplate Propiedad

Definición

Obtiene o establece la fila que representa la plantilla de todas las filas del control.

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 de propiedad

Objeto DataGridViewRow que representa la plantilla de fila.

Atributos

Excepciones

La fila especificada al configurar esta propiedad tiene establecida su propiedadDataGridView.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la plantilla de fila para especificar un alto de fila inicial y un alto de fila mínimo.

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

Comentarios

A veces, desea un mayor control sobre la apariencia de DataGridView las filas que las distintas DataGridView propiedades de estilo de celda proporcionan. La RowTemplate propiedad permite crear e inicializar un DataGridViewRow objeto para usarlo como plantilla por todas las filas, incluida la fila de nuevos registros si AllowUserToAddRows es true.

Esto resulta útil cuando se establecen valores predeterminados para propiedades como el alto de fila. Por ejemplo, puede que desee aumentar el alto de fila predeterminado para proporcionar espacio adicional debajo del contenido de celda normal para mostrar el contenido que abarca varias columnas.

La configuración de la plantilla de fila es necesaria cuando se muestran datos externos mediante tipos personalizados derivados de la DataGridViewRow clase . Con los controles sin enlazar DataGridView , puede rellenar mediante programación la Rows colección con instancias del tipo de fila personalizado. Sin embargo, al mostrar datos externos, las filas se generan automáticamente, pero se basan en la plantilla de fila, que puede establecer en una instancia del tipo de fila personalizado.

Si esta propiedad no se ha establecido la primera vez que recupera su valor, se crea y se devuelve una nueva DataGridViewRow .

Se aplica a

Consulte también