DataGridView.AutoResizeRowHeadersWidth Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Ajusta el ancho de los encabezados de fila para adaptarlos al contenido.

Sobrecargas

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)	Ajusta el ancho de los encabezados de fila utilizando el modo de ajuste de tamaño especificado.
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.
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.
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.

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

Ajusta el ancho de los encabezados de fila utilizando el modo de ajuste de tamaño especificado.

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

rowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode

Uno de los valores de DataGridViewRowHeadersWidthSizeMode.

Excepciones

ArgumentException

rowHeadersWidthSizeMode tiene el valor EnableResizing o DisableResizing.

InvalidEnumArgumentException

rowHeadersWidthSizeMode no es un valor DataGridViewRowHeadersWidthSizeMode válido.

Comentarios

Este método es útil si desea controlar cuándo cambian el tamaño de los encabezados de fila. El ancho de los encabezados de fila se ajusta solo una vez por llamada al método; si el contenido de los encabezados de fila cambia más adelante, los encabezados de fila no se ajustarán automáticamente. Para establecer los encabezados de fila para cambiar automáticamente el tamaño cuando cambie su contenido, use la RowHeadersWidthSizeMode propiedad .

Este método permite especificar un modo de ajuste de tamaño que calcule el nuevo ancho en función de los valores de un conjunto limitado de encabezados, como los de las filas mostradas únicamente. Esto mejora el rendimiento cuando el control contiene un gran número de filas.

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

• DataGridView (Control, formularios Windows Forms)

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.

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.

rowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode

Uno de los valores de DataGridViewRowHeadersWidthSizeMode.

Excepciones

ArgumentOutOfRangeException

rowIndex no está en el intervalo válido de 0 al número de columnas menos 1.

ArgumentException

rowHeadersWidthSizeMode tiene el valor EnableResizing o DisableResizing.

InvalidEnumArgumentException

rowHeadersWidthSizeMode no es un valor DataGridViewRowHeadersWidthSizeMode válido.

Ejemplos

En el ejemplo de código siguiente se muestra cómo cambiar el tamaño de los anchos del encabezado de fila en función de los cambios en el contenido del primer encabezado de fila. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en 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 los encabezados de fila si solo el contenido del encabezado de la fila especificada ha cambiado como resultado de modificaciones de usuario o cambios en un origen de datos enlazado. El ancho de los encabezados de fila se ajusta solo una vez por llamada de método si el cambio de contenido lo requiere; si el contenido de los encabezados de fila cambia más adelante, los encabezados de fila no se ajustarán automáticamente. Para establecer los encabezados de fila para cambiar automáticamente el tamaño cuando cambie su contenido, use la RowHeadersWidthSizeMode propiedad .

Este método permite especificar un modo de ajuste de tamaño que calcule el nuevo ancho en función de los valores de un conjunto limitado de encabezados, como los de las filas mostradas únicamente. Esto mejora el rendimiento cuando el control contiene un gran número de filas.

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

• DataGridView (Control, formularios Windows Forms)

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.

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

rowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode

Uno de los valores de DataGridViewRowHeadersWidthSizeMode.

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.

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.

Excepciones

ArgumentException

rowHeadersWidthSizeMode tiene el valor EnableResizing o DisableResizing.

InvalidEnumArgumentException

rowHeadersWidthSizeMode no es un valor DataGridViewRowHeadersWidthSizeMode válido.

Comentarios

Este método es útil si desea controlar cuándo cambian el tamaño de los encabezados de fila. El ancho de los encabezados de fila se ajusta solo una vez por llamada al método; si el contenido de los encabezados de fila cambia más adelante, los encabezados de fila no se ajustarán automáticamente. Para establecer los encabezados de fila para cambiar automáticamente el tamaño cuando cambie su contenido, use la RowHeadersWidthSizeMode propiedad .

Este método permite especificar un modo de ajuste de tamaño que calcule el nuevo ancho en función de los valores de un conjunto limitado de encabezados, como los de las filas mostradas únicamente. Esto mejora el rendimiento cuando el control contiene un gran número de filas.

Esta sobrecarga está protegida y está diseñada para permitirle lograr relaciones ideales de alto a ancho de celda en una clase derivada DataGridView . Si los fixedColumnHeadersHeight parámetros o fixedRowsHeight son false, el ancho de los encabezados de fila se calculará con la expectativa de que llame a métodos como AutoResizeRows y AutoResizeColumnHeadersHeight a continuación.

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

• DataGridView (Control, formularios Windows Forms)

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.

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.

rowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode

Uno de los valores de DataGridViewRowHeadersWidthSizeMode.

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.

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.

Excepciones

ArgumentOutOfRangeException

rowIndex no está en el intervalo válido de 0 al número de columnas menos 1.

ArgumentException

rowHeadersWidthSizeMode tiene el valor EnableResizing o DisableResizing.

InvalidEnumArgumentException

rowHeadersWidthSizeMode no es un valor DataGridViewRowHeadersWidthSizeMode válido.

Comentarios

Este método es útil si desea controlar cuándo cambian los encabezados de fila si solo el contenido del encabezado de la fila especificada ha cambiado como resultado de modificaciones de usuario o cambios en un origen de datos enlazado. El ancho de los encabezados de fila se ajusta solo una vez por llamada de método si el cambio de contenido lo requiere; si el contenido de los encabezados de fila cambia más adelante, los encabezados de fila no se ajustarán automáticamente. Para establecer los encabezados de fila para cambiar automáticamente el tamaño cuando cambie su contenido, use la RowHeadersWidthSizeMode propiedad .

Este método permite especificar un modo de ajuste de tamaño que calcule el nuevo ancho en función de los valores de un conjunto limitado de encabezados, como los de las filas mostradas únicamente. Esto mejora el rendimiento cuando el control contiene un gran número de filas.

Esta sobrecarga está protegida y está diseñada para permitirle lograr relaciones ideales de alto a ancho de celda en una clase derivada DataGridView . Si los fixedColumnHeadersHeight parámetros o fixedRowHeight son false, el ancho de los encabezados de fila se calculará con la expectativa de que llame a métodos como AutoResizeRows y AutoResizeColumnHeadersHeight a continuación.

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

• DataGridView (Control, formularios Windows Forms)