DataGridView.Font Propiedad

Definición

Obtiene o establece la fuente del texto mostrado por el control DataGridView.Gets or sets the font of the text displayed by the DataGridView.

public:
 virtual property System::Drawing::Font ^ Font { System::Drawing::Font ^ get(); void set(System::Drawing::Font ^ value); };
[System.ComponentModel.Browsable(false)]
public override System.Drawing.Font Font { get; set; }
member this.Font : System.Drawing.Font with get, set
Public Overrides Property Font As Font

Valor de propiedad

Font que se va a aplicar al texto que muestra el control.The Font to apply to the text displayed by the control. El valor predeterminado es el valor de la propiedad DefaultFont.The default is the value of the DefaultFont property.

Atributos

Ejemplos

En el ejemplo de código siguiente se muestra el uso de esta propiedad.The following code example illustrates the use of this property. Este ejemplo forma parte de un ejemplo más grande disponible en [How para: Cree un control DataGridView de Windows Forms sin enlazar @ no__t-0.This example is part of a larger example available in How to: Create an Unbound Windows Forms DataGridView Control.

private void SetupDataGridView()
{
    this.Controls.Add(songsDataGridView);

    songsDataGridView.ColumnCount = 5;

    songsDataGridView.ColumnHeadersDefaultCellStyle.BackColor = Color.Navy;
    songsDataGridView.ColumnHeadersDefaultCellStyle.ForeColor = Color.White;
    songsDataGridView.ColumnHeadersDefaultCellStyle.Font =
        new Font(songsDataGridView.Font, FontStyle.Bold);

    songsDataGridView.Name = "songsDataGridView";
    songsDataGridView.Location = new Point(8, 8);
    songsDataGridView.Size = new Size(500, 250);
    songsDataGridView.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders;
    songsDataGridView.ColumnHeadersBorderStyle =
        DataGridViewHeaderBorderStyle.Single;
    songsDataGridView.CellBorderStyle = DataGridViewCellBorderStyle.Single;
    songsDataGridView.GridColor = Color.Black;
    songsDataGridView.RowHeadersVisible = false;

    songsDataGridView.Columns[0].Name = "Release Date";
    songsDataGridView.Columns[1].Name = "Track";
    songsDataGridView.Columns[2].Name = "Title";
    songsDataGridView.Columns[3].Name = "Artist";
    songsDataGridView.Columns[4].Name = "Album";
    songsDataGridView.Columns[4].DefaultCellStyle.Font =
        new Font(songsDataGridView.DefaultCellStyle.Font, FontStyle.Italic);

    songsDataGridView.SelectionMode =
        DataGridViewSelectionMode.FullRowSelect;
    songsDataGridView.MultiSelect = false;
    songsDataGridView.Dock = DockStyle.Fill;

    songsDataGridView.CellFormatting += new
        DataGridViewCellFormattingEventHandler(
        songsDataGridView_CellFormatting);
}
Private Sub SetupDataGridView()

    Me.Controls.Add(songsDataGridView)

    songsDataGridView.ColumnCount = 5
    With songsDataGridView.ColumnHeadersDefaultCellStyle
        .BackColor = Color.Navy
        .ForeColor = Color.White
        .Font = New Font(songsDataGridView.Font, FontStyle.Bold)
    End With

    With songsDataGridView
        .Name = "songsDataGridView"
        .Location = New Point(8, 8)
        .Size = New Size(500, 250)
        .AutoSizeRowsMode = _
            DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders
        .ColumnHeadersBorderStyle = DataGridViewHeaderBorderStyle.Single
        .CellBorderStyle = DataGridViewCellBorderStyle.Single
        .GridColor = Color.Black
        .RowHeadersVisible = False

        .Columns(0).Name = "Release Date"
        .Columns(1).Name = "Track"
        .Columns(2).Name = "Title"
        .Columns(3).Name = "Artist"
        .Columns(4).Name = "Album"
        .Columns(4).DefaultCellStyle.Font = _
            New Font(Me.songsDataGridView.DefaultCellStyle.Font, FontStyle.Italic)

        .SelectionMode = DataGridViewSelectionMode.FullRowSelect
        .MultiSelect = False
        .Dock = DockStyle.Fill
    End With

End Sub

Comentarios

La propiedad Font es una propiedad de ambiente.The Font property is an ambient property. Una propiedad de ambiente es una propiedad de control que, si no se establece, se recupera del control primario.An ambient property is a control property that, if not set, is retrieved from the parent control. Por ejemplo, un Button tendrá el mismo BackColor que el elemento primario Form de forma predeterminada.For example, a Button will have the same BackColor as its parent Form by default. Para obtener más información sobre las propiedades de ambiente, vea la clase AmbientProperties o la información general sobre la clase Control.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Dado que el Font es inmutable (lo que significa que no se puede ajustar ninguna de sus propiedades), solo se puede asignar a la propiedad Font un nuevo objeto Font.Because the Font is immutable (meaning that you cannot adjust any of its properties), you can only assign the Font property a new Font object. Sin embargo, puede basar la nueva fuente en la fuente existente.However, you can base the new font on the existing font.

El control DataGridView usa el valor de la propiedad Font como valor predeterminado de las propiedades Font de los objetos DataGridViewCellStyle devueltos por las propiedades DefaultCellStyle, ColumnHeadersDefaultCellStyle y RowHeadersDefaultCellStyle.The DataGridView control uses the value of the Font property as the default value of the Font properties of DataGridViewCellStyle objects returned by the DefaultCellStyle, ColumnHeadersDefaultCellStyle, and RowHeadersDefaultCellStyle properties. Al cambiar el valor de Font, se actualizan automáticamente las propiedades DefaultCellStyle, ColumnHeadersDefaultCellStyle y RowHeadersDefaultCellStyle, cambiando la fuente de cualquier celda que herede el valor.Changing the Font value automatically updates the DefaultCellStyle, ColumnHeadersDefaultCellStyle, and RowHeadersDefaultCellStyle properties, changing the font for any cell that inherits the value. Las celdas de encabezado invalidan el valor de forma predeterminada y puede invalidar el valor de filas, columnas y celdas específicas.Header cells override the value by default, and you can override the value for specific rows, columns, and cells. Para obtener más información sobre la herencia del estilo de celda, vea estilos de celda en el control DataGridView de Windows Forms.For more information about cell style inheritance, see Cell Styles in the Windows Forms DataGridView Control.

Se aplica a

Consulte también: