DataGridView.AutoResizeRowHeadersWidth Método

Definición

Ajusta el ancho de los encabezados de fila para adaptarlos al contenido.Adjusts the width of the row headers to fit the header contents.

Sobrecargas

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

Ajusta el ancho de los encabezados de fila utilizando el modo de ajuste de tamaño especificado.Adjusts the width of the row headers using the specified size mode.

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

Ajusta el ancho de los encabezados de fila en función de los cambios de contenido del encabezado de la fila especificada y utilizando el modo de ajuste de tamaño especificado.Adjusts the width of the row headers based on changes to the contents of the header in the specified row and using the specified size mode.

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Ajusta el ancho de los encabezados de fila utilizando el modo de ajuste de tamaño especificado y, opcionalmente, calcula el ancho con la expectativa de que se ajuste a continuación el ancho de los encabezados de fila o los encabezados de columna.Adjusts the width of the row headers using the specified size mode, optionally calculating the width with the expectation that the row and/or column header widths will subsequently be adjusted.

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

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

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

Ajusta el ancho de los encabezados de fila utilizando el modo de ajuste de tamaño especificado.Adjusts the width of the row headers using the specified size mode.

public:
 void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)

Parámetros

Excepciones

rowHeadersWidthSizeMode tiene el valor EnableResizing o DisableResizing.rowHeadersWidthSizeMode has the value EnableResizing or DisableResizing.

rowHeadersWidthSizeMode no es un valor DataGridViewRowHeadersWidthSizeMode válido.rowHeadersWidthSizeMode is not a valid DataGridViewRowHeadersWidthSizeMode value.

Comentarios

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

Este método permite especificar un modo de ajuste de tamaño que calcula el nuevo ancho en función de los valores de un conjunto limitado de encabezados, como los de las filas mostradas únicamente.This method lets you specify a sizing mode that calculates the new width based on values in a limited set of headers, such as those in displayed rows only. Esto mejora el rendimiento cuando el control contiene un gran número de filas.This improves performance when the control contains a large number of rows.

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:

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

Ajusta el ancho de los encabezados de fila en función de los cambios de contenido del encabezado de la fila especificada y utilizando el modo de ajuste de tamaño especificado.Adjusts the width of the row headers based on changes to the contents of the header in the specified row and using the specified size mode.

public:
 void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)

Parámetros

rowIndex
Int32

Índice del encabezado de fila con el contenido cambiado.The index of the row header with the changed content.

Excepciones

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

rowHeadersWidthSizeMode tiene el valor EnableResizing o DisableResizingrowHeadersWidthSizeMode has the value EnableResizing or DisableResizing

rowHeadersWidthSizeMode no es un valor DataGridViewRowHeadersWidthSizeMode válido.rowHeadersWidthSizeMode is not a valid DataGridViewRowHeadersWidthSizeMode value.

Ejemplos

En el ejemplo de código siguiente se muestra cómo cambiar el ancho de los encabezados de fila en función de los cambios realizados en el contenido del primer encabezado de fila.The following code example illustrates how to resize the row header widths based on changes to the contents of the first row header. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en [How para: Cambiar mediante programación el tamaño de las celdas para ajustar el contenido en el Windows Forms control DataGridView @ no__t-0.This code example is part of a larger example provided in How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

void SizeFirstRowHeaderToAllHeaders( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRowHeadersWidth(0, DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders);
}


private void SizeFirstRowHeaderToAllHeaders(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRowHeadersWidth(
        0, DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}
Private Sub SizeFirstRowHeaderToAllHeaders(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    DataGridView1.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)

End Sub

Comentarios

Este método es útil si desea controlar cuándo cambian de tamaño los encabezados de fila si solo el contenido del encabezado de la fila 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 row headers resize if only the contents of the header in the specified row have changed as a result of user edits or changes to a bound data source. El ancho de los encabezados de fila 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 fila cambia posteriormente, los encabezados de fila no se ajustarán automáticamente.The width of the row headers is adjusted only once per method call if the content change requires it; if the contents of the row headers later change, the row headers will not automatically adjust. Para establecer que los encabezados de fila cambien de tamaño automáticamente cuando cambie su contenido, use la propiedad RowHeadersWidthSizeMode.To set the row headers to automatically resize when their contents change, use the RowHeadersWidthSizeMode property.

Este método permite especificar un modo de ajuste de tamaño que calcula el nuevo ancho en función de los valores de un conjunto limitado de encabezados, como los de las filas mostradas únicamente.This method lets you specify a sizing mode that calculates the new width based on values in a limited set of headers, such as those in displayed rows only. Esto mejora el rendimiento cuando el control contiene un gran número de filas.This improves performance when the control contains a large number of rows.

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:

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

Ajusta el ancho de los encabezados de fila utilizando el modo de ajuste de tamaño especificado y, opcionalmente, calcula el ancho con la expectativa de que se ajuste a continuación el ancho de los encabezados de fila o los encabezados de columna.Adjusts the width of the row headers using the specified size mode, optionally calculating the width with the expectation that the row and/or column header widths will subsequently be adjusted.

protected:
 void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
protected void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowsHeight As Boolean)

Parámetros

fixedColumnHeadersHeight
Boolean

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

fixedRowsHeight
Boolean

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

Excepciones

rowHeadersWidthSizeMode tiene el valor EnableResizing o DisableResizing.rowHeadersWidthSizeMode has the value EnableResizing or DisableResizing.

rowHeadersWidthSizeMode no es un valor DataGridViewRowHeadersWidthSizeMode válido.rowHeadersWidthSizeMode is not a valid DataGridViewRowHeadersWidthSizeMode value.

Comentarios

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

Este método permite especificar un modo de ajuste de tamaño que calcula el nuevo ancho en función de los valores de un conjunto limitado de encabezados, como los de las filas mostradas únicamente.This method lets you specify a sizing mode that calculates the new width based on values in a limited set of headers, such as those in displayed rows only. Esto mejora el rendimiento cuando el control contiene un gran número de filas.This improves performance when the control contains a large number of rows.

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 fixedColumnHeadersHeight o fixedRowsHeight son @no__t 2, el ancho de los encabezados de fila se calculará con la expectativa de que se llame a métodos como AutoResizeRows y AutoResizeColumnHeadersHeight Next.If the fixedColumnHeadersHeight or fixedRowsHeight parameters are false, the width of the row headers will be calculated with the expectation that you will call methods such as AutoResizeRows and AutoResizeColumnHeadersHeight 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:

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

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

protected:
 void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
protected void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowHeight As Boolean)

Parámetros

rowIndex
Int32

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

fixedColumnHeadersHeight
Boolean

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

fixedRowHeight
Boolean

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

Excepciones

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

rowHeadersWidthSizeMode tiene el valor EnableResizing o DisableResizing.rowHeadersWidthSizeMode has the value EnableResizing or DisableResizing.

rowHeadersWidthSizeMode no es un valor DataGridViewRowHeadersWidthSizeMode válido.rowHeadersWidthSizeMode is not a valid DataGridViewRowHeadersWidthSizeMode value.

Comentarios

Este método es útil si desea controlar cuándo cambian de tamaño los encabezados de fila si solo el contenido del encabezado de la fila 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 row headers resize if only the contents of the header in the specified row have changed as a result of user edits or changes to a bound data source. El ancho de los encabezados de fila 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 fila cambia posteriormente, los encabezados de fila no se ajustarán automáticamente.The width of the row headers is adjusted only once per method call if the content change requires it; if the contents of the row headers later change, the row headers will not automatically adjust. Para establecer que los encabezados de fila cambien de tamaño automáticamente cuando cambie su contenido, use la propiedad RowHeadersWidthSizeMode.To set the row headers to automatically resize when their contents change, use the RowHeadersWidthSizeMode property.

Este método permite especificar un modo de ajuste de tamaño que calcula el nuevo ancho en función de los valores de un conjunto limitado de encabezados, como los de las filas mostradas únicamente.This method lets you specify a sizing mode that calculates the new width based on values in a limited set of headers, such as those in displayed rows only. Esto mejora el rendimiento cuando el control contiene un gran número de filas.This improves performance when the control contains a large number of rows.

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 fixedColumnHeadersHeight o fixedRowHeight son @no__t 2, el ancho de los encabezados de fila se calculará con la expectativa de que se llame a métodos como AutoResizeRows y AutoResizeColumnHeadersHeight Next.If the fixedColumnHeadersHeight or fixedRowHeight parameters are false, the width of the row headers will be calculated with the expectation that you will call methods such as AutoResizeRows and AutoResizeColumnHeadersHeight 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:

Se aplica a