DataGridView.RowTemplate Propiedad

Definición

Obtiene o establece la fila que representa la plantilla de todas las filas del control.Gets or sets the row that represents the template for all the rows in the 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; }
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.A DataGridViewRow representing the row template.

Atributos

Excepciones

La fila especificada al configurar esta propiedad tiene establecida su propiedadDataGridView.The specified row when setting this property has its DataGridView property set.

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.The following code example illustrates how to use the row template to specify an initial row height and a minimum row height.

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 tener un mayor control sobre la apariencia de las filas DataGridView que las proporcionadas por las diversas propiedades de estilo de celda DataGridView.Sometimes you want greater control over the appearance of DataGridView rows than what is provided by the various DataGridView cell style properties. La propiedad RowTemplate permite crear e inicializar un DataGridViewRow para utilizarlo como plantilla en todas las filas, incluida la fila para los nuevos registros si AllowUserToAddRows es true.The RowTemplate property lets you create and initialize a DataGridViewRow for use as a template by all rows, including the row for new records if AllowUserToAddRows is true.

Esto resulta útil cuando se configuran los valores predeterminados para propiedades como el alto de las filas.This is useful when you are setting default values for properties such as row height. Por ejemplo, puede que desee aumentar el alto de fila predeterminado con el fin de proporcionar espacio adicional debajo del contenido de la celda normal para mostrar el contenido que abarca varias columnas.For example, you may want to increase the default row height in order to provide extra room beneath ordinary cell content for displaying content that spans multiple columns.

Es necesario establecer la plantilla de fila cuando se muestran datos externos mediante tipos personalizados derivados de la clase DataGridViewRow.Setting the row template is necessary when external data is displayed using custom types derived from the DataGridViewRow class. Con los controles DataGridView sin enlazar, puede rellenar mediante programación la colección Rows con instancias del tipo de fila personalizado.With unbound DataGridView controls, you can programmatically populate the Rows collection with instances of your custom row type. Sin embargo, cuando se muestran datos externos, las filas se generan automáticamente, pero se basan en la plantilla de fila, que se puede establecer en una instancia del tipo de fila personalizado.When displaying external data, however, the rows are generated automatically, but they are based on the row template, which you can set to an instance of your custom row type.

Si esta propiedad no se ha establecido la primera vez que se recupera su valor, se crea un nuevo DataGridViewRow y se devuelve.If this property has not been set the first time you retrieve its value, a new DataGridViewRow is created and returned.

Se aplica a

Consulte también: