DataGridView.AutoResizeColumnHeadersHeight Método

Definición

Ajusta el alto de los encabezados de columna para ajustar el contenido del encabezado.Adjusts the height of the column headers to fit the header contents.

Sobrecargas

AutoResizeColumnHeadersHeight(Int32, Boolean, Boolean)

Ajusta el alto de los encabezados de columna en función de los cambios del contenido del encabezado de la columna especificada y, opcionalmente, calcula el alto con la expectativa de que se ajuste a continuación el ancho de los encabezados de columna o los encabezados de fila.Adjusts the height of the column headers based on changes to the contents of the header in the specified column, optionally calculating the height with the expectation that the column and/or row header widths will subsequently be adjusted.

AutoResizeColumnHeadersHeight(Boolean, Boolean)

Ajusta el alto de los encabezados de columna para adaptarlos al contenido y, opcionalmente, calcula el alto con la expectativa de que se ajuste a continuación el ancho de los encabezados de columna o los encabezados de fila.Adjusts the height of the column headers to fit their contents, optionally calculating the height with the expectation that the column and/or row header widths will subsequently be adjusted.

AutoResizeColumnHeadersHeight()

Ajusta el alto de los encabezados de columna para adaptarlos al contenido del encabezado de columna más grande.Adjusts the height of the column headers to fit the contents of the largest column header.

AutoResizeColumnHeadersHeight(Int32)

Ajusta el alto de los encabezados de columna para adaptarlos a cambios de contenido del encabezado de la columna especificada.Adjusts the height of the column headers based on changes to the contents of the header in the specified column.

AutoResizeColumnHeadersHeight(Int32, Boolean, Boolean)

Ajusta el alto de los encabezados de columna en función de los cambios del contenido del encabezado de la columna especificada y, opcionalmente, calcula el alto con la expectativa de que se ajuste a continuación el ancho de los encabezados de columna o los encabezados de fila.Adjusts the height of the column headers based on changes to the contents of the header in the specified column, optionally calculating the height with the expectation that the column and/or row header widths will subsequently be adjusted.

protected:
 void AutoResizeColumnHeadersHeight(int columnIndex, bool fixedRowHeadersWidth, bool fixedColumnWidth);
protected void AutoResizeColumnHeadersHeight (int columnIndex, bool fixedRowHeadersWidth, bool fixedColumnWidth);
member this.AutoResizeColumnHeadersHeight : int * bool * bool -> unit
Protected Sub AutoResizeColumnHeadersHeight (columnIndex As Integer, fixedRowHeadersWidth As Boolean, fixedColumnWidth As Boolean)

Parámetros

columnIndex
Int32

Índice del encabezado de columna cuyo contenido se utilizará para determinar el nuevo alto.The index of the column header whose contents should be used to determine new height.

fixedRowHeadersWidth
Boolean

Estrue para calcular el nuevo alto a partir del ancho actual de los encabezados de fila; es false para calcular el alto con la expectativa de que también se ajuste el ancho de los encabezados de fila.true to calculate the new height based on the current width of the row headers; false to calculate the height with the expectation that the row headers width will also be adjusted.

fixedColumnWidth
Boolean

Es true para calcular el nuevo alto a partir del ancho actual de la columna especificada; es false para calcular el alto con la expectativa de que también se ajuste el ancho de las columnas.true to calculate the new height based on the current width of the specified column; false to calculate the height with the expectation that the column width will also be adjusted.

Excepciones

columnIndex no está en el intervalo válido de 0 para el número de columnas menos 1.columnIndex is not in the valid range of 0 to the number of columns minus 1.

Comentarios

Este método es útil si desea controlar cuándo cambian de tamaño los encabezados de columna si solo el contenido del encabezado de la columna especificada ha cambiado como resultado de las modificaciones de usuario o de los cambios en un origen de datos enlazado.This method is useful if you want to control when the column headers resize if only the contents of the header in the specified column have changed as a result of user edits or changes to a bound data source. El alto de los encabezados de columna solo se ajusta una vez por cada llamada al método si lo requiere el cambio de contenido; Si el contenido de los encabezados de columna cambia posteriormente, los encabezados de columna no se ajustarán automáticamente.The height of the column headers is adjusted only once per method call if the content change requires it; if the contents of the column headers later change, the column headers will not automatically adjust. Para establecer que los encabezados de columna cambien de tamaño automáticamente cuando cambie su contenido, use la propiedad ColumnHeadersHeightSizeMode.To set the column headers to automatically resize when their contents change, use the ColumnHeadersHeightSizeMode property.

Para que el contenido de la celda se ajuste en varias líneas cuando se cambia el tamaño de los encabezados de columna, el estilo de celda en vigor para la celda debe tener un valor de propiedad WrapMode de True.For cell contents to wrap onto multiple lines when the column headers are resized, the cell style in effect for the cell must have a WrapMode property value of True.

Esta sobrecarga está protegida y está diseñada para que pueda lograr las relaciones ideales de alto a ancho de celda en una clase derivada de DataGridView.This overload is protected and is designed to enable you to achieve ideal cell height-to-width ratios in a derived DataGridView class. Si los parámetros fixedColumnWidth o fixedRowHeadersWidth son @no__t 2, el alto de los encabezados de columna se calculará con la expectativa de que llame a los métodos como AutoResizeColumns y AutoResizeRowHeadersWidth Next.If the fixedColumnWidth or fixedRowHeadersWidth parameters are false, the height of the column headers will be calculated with the expectation that you will call the methods such as AutoResizeColumns and AutoResizeRowHeadersWidth next.

Para obtener más información sobre el cambio de tamaño mediante programación, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Consulte también:

AutoResizeColumnHeadersHeight(Boolean, Boolean)

Ajusta el alto de los encabezados de columna para adaptarlos al contenido y, opcionalmente, calcula el alto con la expectativa de que se ajuste a continuación el ancho de los encabezados de columna o los encabezados de fila.Adjusts the height of the column headers to fit their contents, optionally calculating the height with the expectation that the column and/or row header widths will subsequently be adjusted.

protected:
 void AutoResizeColumnHeadersHeight(bool fixedRowHeadersWidth, bool fixedColumnsWidth);
protected void AutoResizeColumnHeadersHeight (bool fixedRowHeadersWidth, bool fixedColumnsWidth);
member this.AutoResizeColumnHeadersHeight : bool * bool -> unit
Protected Sub AutoResizeColumnHeadersHeight (fixedRowHeadersWidth As Boolean, fixedColumnsWidth As Boolean)

Parámetros

fixedRowHeadersWidth
Boolean

Es true para calcular el nuevo alto a partir del ancho actual de los encabezados de fila; es false para calcular el alto con la expectativa de que también se ajuste el ancho de los encabezados de fila.true to calculate the new height based on the current width of the row headers; false to calculate the height with the expectation that the row headers width will also be adjusted.

fixedColumnsWidth
Boolean

Es true para calcular el nuevo alto a partir del ancho actual de las columnas; es false para calcular el alto con la expectativa de que también se ajuste el ancho de las columnas.true to calculate the new height based on the current column widths; false to calculate the height with the expectation that the column widths will also be adjusted.

Comentarios

Este método es útil si desea controlar cuándo se cambia el tamaño de los encabezados de columna.This method is useful if you want to control when the column headers resize. El alto de los encabezados de columna solo se ajusta una vez por cada llamada al método. Si el contenido de los encabezados de columna cambia posteriormente, los encabezados de columna no se ajustarán automáticamente.The height of the column headers is adjusted only once per method call; if the contents of the column headers later change, the column headers will not automatically adjust. Para establecer que los encabezados de columna cambien de tamaño automáticamente cuando cambie su contenido, use la propiedad ColumnHeadersHeightSizeMode.To set the column headers to automatically resize when their contents change, use the ColumnHeadersHeightSizeMode property.

Para que el contenido de la celda se ajuste en varias líneas cuando se cambia el tamaño de los encabezados de columna, el estilo de celda en vigor para la celda debe tener un valor de propiedad WrapMode de True.For cell contents to wrap onto multiple lines when the column headers are resized, the cell style in effect for the cell must have a WrapMode property value of True.

Esta sobrecarga está protegida y está diseñada para que pueda lograr las relaciones ideales de alto a ancho de celda en una clase derivada de DataGridView.This overload is protected and is designed to enable you to achieve ideal cell height-to-width ratios in a derived DataGridView class. Si los parámetros fixedColumnsWidth o fixedRowHeadersWidth son @no__t 2, el alto de los encabezados de columna se calculará con la expectativa de que llame a los métodos como AutoResizeColumns y AutoResizeRowHeadersWidth Next.If the fixedColumnsWidth or fixedRowHeadersWidth parameters are false, the height of the column headers will be calculated with the expectation that you will call the methods such as AutoResizeColumns and AutoResizeRowHeadersWidth next.

Para obtener más información sobre el cambio de tamaño mediante programación, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Consulte también:

AutoResizeColumnHeadersHeight()

Ajusta el alto de los encabezados de columna para adaptarlos al contenido del encabezado de columna más grande.Adjusts the height of the column headers to fit the contents of the largest column header.

public:
 void AutoResizeColumnHeadersHeight();
public void AutoResizeColumnHeadersHeight ();
member this.AutoResizeColumnHeadersHeight : unit -> unit
Public Sub AutoResizeColumnHeadersHeight ()

Ejemplos

En el ejemplo de código siguiente se muestra cómo cambiar el tamaño de los encabezados de columna y las filas como resultado de un clic en un botón.The following code example demonstrates how to resize column headers and rows as a result of a button click.

void Button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   // Resize the height of the column headers. 
   dataGridView1->AutoResizeColumnHeadersHeight();

   // Resize all the row heights to fit the contents of all non-header cells.
   dataGridView1->AutoResizeRows(
         DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void button1_Click(object sender, System.EventArgs e)
{
    // Resize the height of the column headers. 
    dataGridView1.AutoResizeColumnHeadersHeight();

    // Resize all the row heights to fit the contents of all non-header cells.
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles button1.Click

    ' Resize the height of the column headers. 
    dataGridView1.AutoResizeColumnHeadersHeight()

    ' Resize all the row heights to fit the contents of all 
    ' non-header cells.
    dataGridView1.AutoResizeRows( _
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Comentarios

Este método es útil si desea controlar cuándo se cambia el tamaño de los encabezados de columna.This method is useful if you want to control when the column headers resize. El alto de los encabezados de columna solo se ajusta una vez por cada llamada al método. Si el contenido de los encabezados de columna cambia posteriormente, los encabezados de columna no se ajustarán automáticamente.The height of the column headers is adjusted only once per method call; if the contents of the column headers later change, the column headers will not automatically adjust. Para establecer que los encabezados de columna cambien de tamaño automáticamente cuando cambie su contenido, use la propiedad ColumnHeadersHeightSizeMode.To set the column headers to automatically resize when their contents change, use the ColumnHeadersHeightSizeMode property.

Para que el contenido de la celda se ajuste en varias líneas cuando se cambia el tamaño de los encabezados de columna, el estilo de celda en vigor para la celda debe tener un valor de propiedad WrapMode de True.For cell contents to wrap onto multiple lines when the column headers are resized, the cell style in effect for the cell must have a WrapMode property value of True.

Para obtener más información sobre el cambio de tamaño mediante programación, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Consulte también:

AutoResizeColumnHeadersHeight(Int32)

Ajusta el alto de los encabezados de columna para adaptarlos a cambios de contenido del encabezado de la columna especificada.Adjusts the height of the column headers based on changes to the contents of the header in the specified column.

public:
 void AutoResizeColumnHeadersHeight(int columnIndex);
public void AutoResizeColumnHeadersHeight (int columnIndex);
member this.AutoResizeColumnHeadersHeight : int -> unit
Public Sub AutoResizeColumnHeadersHeight (columnIndex As Integer)

Parámetros

columnIndex
Int32

Índice de la columna que contiene el encabezado con el contenido cambiado.The index of the column containing the header with the changed content.

Excepciones

columnIndex no está en el intervalo válido de 0 para el número de columnas menos 1.columnIndex is not in the valid range of 0 to the number of columns minus 1.

Comentarios

Este método es útil si desea controlar cuándo cambian de tamaño los encabezados de columna si solo el contenido del encabezado de la columna especificada ha cambiado como resultado de las modificaciones de usuario o de los cambios en un origen de datos enlazado.This method is useful if you want to control when the column headers resize if only the contents of the header in the specified column have changed as a result of user edits or changes to a bound data source. El alto de los encabezados de columna solo se ajusta una vez por cada llamada al método si lo requiere el cambio de contenido; Si el contenido de los encabezados de columna cambia posteriormente, los encabezados de columna no se ajustarán automáticamente.The height of the column headers is adjusted only once per method call if the content change requires it; if the contents of the column headers later change, the column headers will not automatically adjust. Para establecer que los encabezados de columna cambien de tamaño automáticamente cuando cambie su contenido, use la propiedad ColumnHeadersHeightSizeMode.To set the column headers to automatically resize when their contents change, use the ColumnHeadersHeightSizeMode property.

Para que el contenido de la celda se ajuste en varias líneas cuando se cambia el tamaño de los encabezados de columna, el estilo de celda en vigor para la celda debe tener un valor de propiedad WrapMode de True.For cell contents to wrap onto multiple lines when the column headers are resized, the cell style in effect for the cell must have a WrapMode property value of True.

Para obtener más información sobre el cambio de tamaño mediante programación, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about programmatic resizing, see Sizing Options in the Windows Forms DataGridView Control.

Consulte también:

Se aplica a