DataGridViewRowHeadersWidthSizeMode Enumeración

Definición

Define los valores para especificar cómo se ajusta el ancho del encabezado de fila.Defines values for specifying how the row header width is adjusted.

public enum class DataGridViewRowHeadersWidthSizeMode
public enum DataGridViewRowHeadersWidthSizeMode
type DataGridViewRowHeadersWidthSizeMode = 
Public Enum DataGridViewRowHeadersWidthSizeMode
Herencia
DataGridViewRowHeadersWidthSizeMode

Campos

AutoSizeToAllHeaders 2

El ancho del encabezado de fila se adapta para ajustarse al contenido de todas las celdas de encabezado de fila.The row header width adjusts to fit the contents of all the row header cells.

AutoSizeToDisplayedHeaders 3

El ancho del encabezado de fila se adapta para ajustarse al contenido de todos los encabezados de fila de las filas mostradas en ese momento.The row header width adjusts to fit the contents of all the row headers in the currently displayed rows.

AutoSizeToFirstHeader 4

El ancho del encabezado de fila se adapta para ajustarse al contenido del primer encabezado de fila.The row header width adjusts to fit the contents of the first row header.

DisableResizing 1

Los usuarios no pueden ajustar el ancho de los encabezados de columna con el mouse.Users cannot adjust the column header width with the mouse.

EnableResizing 0

Los usuarios pueden ajustar el ancho de los encabezados de columna con el mouse.Users can adjust the column header width with the mouse.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de esta enumeración en un control no interactivo DataGridView de solo presentación.The following code example illustrates the use of this enumeration in a display-only, non-interactive DataGridView control.

// Configures the appearance and behavior of a DataGridView control.
private void InitializeDataGridView()
{
    // Initialize basic DataGridView properties.
    dataGridView1.Dock = DockStyle.Fill;
    dataGridView1.BackgroundColor = Color.LightGray;
    dataGridView1.BorderStyle = BorderStyle.Fixed3D;

    // Set property values appropriate for read-only display and 
    // limited interactivity. 
    dataGridView1.AllowUserToAddRows = false;
    dataGridView1.AllowUserToDeleteRows = false;
    dataGridView1.AllowUserToOrderColumns = true;
    dataGridView1.ReadOnly = true;
    dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect;
    dataGridView1.MultiSelect = false;
    dataGridView1.AutoSizeRowsMode = DataGridViewAutoSizeRowsMode.None;
    dataGridView1.AllowUserToResizeColumns = false;
    dataGridView1.ColumnHeadersHeightSizeMode = 
        DataGridViewColumnHeadersHeightSizeMode.DisableResizing;
    dataGridView1.AllowUserToResizeRows = false;
    dataGridView1.RowHeadersWidthSizeMode = 
        DataGridViewRowHeadersWidthSizeMode.DisableResizing;

    // Set the selection background color for all the cells.
    dataGridView1.DefaultCellStyle.SelectionBackColor = Color.White;
    dataGridView1.DefaultCellStyle.SelectionForeColor = Color.Black;

    // Set RowHeadersDefaultCellStyle.SelectionBackColor so that its default
    // value won't override DataGridView.DefaultCellStyle.SelectionBackColor.
    dataGridView1.RowHeadersDefaultCellStyle.SelectionBackColor = Color.Empty;

    // Set the background color for all rows and for alternating rows. 
    // The value for alternating rows overrides the value for all rows. 
    dataGridView1.RowsDefaultCellStyle.BackColor = Color.LightGray;
    dataGridView1.AlternatingRowsDefaultCellStyle.BackColor = Color.DarkGray;

    // Set the row and column header styles.
    dataGridView1.ColumnHeadersDefaultCellStyle.ForeColor = Color.White;
    dataGridView1.ColumnHeadersDefaultCellStyle.BackColor = Color.Black;
    dataGridView1.RowHeadersDefaultCellStyle.BackColor = Color.Black;

    // Set the Format property on the "Last Prepared" column to cause
    // the DateTime to be formatted as "Month, Year".
    dataGridView1.Columns["Last Prepared"].DefaultCellStyle.Format = "y";

    // Specify a larger font for the "Ratings" column. 
    using (Font font = new Font(
        dataGridView1.DefaultCellStyle.Font.FontFamily, 25, FontStyle.Bold))
    {
        dataGridView1.Columns["Rating"].DefaultCellStyle.Font = font;
    }

    // Attach a handler to the CellFormatting event.
    dataGridView1.CellFormatting += new
        DataGridViewCellFormattingEventHandler(dataGridView1_CellFormatting);
}
' Configures the appearance and behavior of a DataGridView control.
Private Sub InitializeDataGridView()

    ' Initialize basic DataGridView properties.
    dataGridView1.Dock = DockStyle.Fill
    dataGridView1.BackgroundColor = Color.LightGray
    dataGridView1.BorderStyle = BorderStyle.Fixed3D

    ' Set property values appropriate for read-only display and 
    ' limited interactivity. 
    dataGridView1.AllowUserToAddRows = False
    dataGridView1.AllowUserToDeleteRows = False
    dataGridView1.AllowUserToOrderColumns = True
    dataGridView1.ReadOnly = True
    dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect
    dataGridView1.MultiSelect = False
    dataGridView1.AutoSizeRowsMode = DataGridViewAutoSizeRowsMode.None
    dataGridView1.AllowUserToResizeColumns = False
    dataGridView1.ColumnHeadersHeightSizeMode = _
        DataGridViewColumnHeadersHeightSizeMode.DisableResizing
    dataGridView1.AllowUserToResizeRows = False
    dataGridView1.RowHeadersWidthSizeMode = _
        DataGridViewRowHeadersWidthSizeMode.DisableResizing

    ' Set the selection background color for all the cells.
    dataGridView1.DefaultCellStyle.SelectionBackColor = Color.White
    dataGridView1.DefaultCellStyle.SelectionForeColor = Color.Black

    ' Set RowHeadersDefaultCellStyle.SelectionBackColor so that its default
    ' value won't override DataGridView.DefaultCellStyle.SelectionBackColor.
    dataGridView1.RowHeadersDefaultCellStyle.SelectionBackColor = Color.Empty

    ' Set the background color for all rows and for alternating rows. 
    ' The value for alternating rows overrides the value for all rows. 
    dataGridView1.RowsDefaultCellStyle.BackColor = Color.LightGray
    dataGridView1.AlternatingRowsDefaultCellStyle.BackColor = Color.DarkGray

    ' Set the row and column header styles.
    dataGridView1.ColumnHeadersDefaultCellStyle.ForeColor = Color.White
    dataGridView1.ColumnHeadersDefaultCellStyle.BackColor = Color.Black
    dataGridView1.RowHeadersDefaultCellStyle.BackColor = Color.Black

    ' Set the Format property on the "Last Prepared" column to cause
    ' the DateTime to be formatted as "Month, Year".
    dataGridView1.Columns("Last Prepared").DefaultCellStyle.Format = "y"

    ' Specify a larger font for the "Ratings" column. 
    Dim font As New Font( _
        dataGridView1.DefaultCellStyle.Font.FontFamily, 25, FontStyle.Bold)
    Try
        dataGridView1.Columns("Rating").DefaultCellStyle.Font = font
    Finally
        font.Dispose()
    End Try

End Sub

Comentarios

De forma predeterminada, los usuarios pueden cambiar el ancho de los encabezados de fila.By default, users can resize the width of the row headers. Puede deshabilitar esta capacidad para establecer un ancho fijo, o puede usar un modo de ajuste de tamaño automático basado en el contenido, lo que también deshabilita el cambio de tamaño del usuario.You can disable this ability to set a fixed width, or you can use a content-based automatic sizing mode, which also disables user resizing.

El DataGridView control puede ajustar el ancho de los encabezados de fila para que quepa todo su contenido, solo el contenido del primer encabezado o solo el contenido de los encabezados que se muestran actualmente.The DataGridView control can adjust the width of its row headers to fit all their contents, only the contents of the first header, or only the contents of currently displayed headers. Calcular el nuevo ancho mediante un subconjunto de encabezados resulta útil para evitar una reducción del rendimiento al trabajar con muchas filas de datos.Calculating the new width using a subset of headers is useful to avoid a performance penalty when working with many rows of data.

Esta enumeración la usan la DataGridView propiedad RowHeadersWidthSizeMode de control AutoResizeRowHeadersWidth y el método.This enumeration is used by the DataGridView control RowHeadersWidthSizeMode property and AutoResizeRowHeadersWidth method.

Para obtener más información sobre los modos de ajuste de tamaño, consulte Opciones de ajuste de tamaño en el control DataGridView Windows Forms.For more information about sizing modes, see Sizing Options in the Windows Forms DataGridView Control.

Se aplica a

Consulte también: