DataGridView.Font Propiedad

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene o establece la fuente del texto mostrado por el control 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; }

[<System.ComponentModel.Browsable(false)>]
member this.Font : System.Drawing.Font with get, set

Public Overrides Property Font As Font

Valor de propiedad

Font

Font que se va a aplicar al texto que muestra el control. El valor predeterminado es el valor de la propiedad DefaultFont.

Atributos: BrowsableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra el uso de esta propiedad. Este ejemplo forma parte de un ejemplo más grande disponible en 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 Font propiedad es una propiedad ambiental. Una propiedad ambiente es una propiedad de control que, si no se establece, se recupera del control primario. Por ejemplo, un Button tendrá lo mismo BackColor que su elemento primario Form de forma predeterminada. Para obtener más información sobre las propiedades ambientales, vea la AmbientProperties clase o la información general de la Control clase.

Dado que es Font inmutable (lo que significa que no se puede ajustar ninguna de sus propiedades), solo se puede asignar a la Font propiedad un nuevo Font objeto. Sin embargo, puede basar la nueva fuente en la fuente existente.

El DataGridView control usa el valor de la Font propiedad como valor predeterminado de las Font propiedades de DataGridViewCellStyle los objetos devueltos por las DefaultCellStylepropiedades , ColumnHeadersDefaultCellStyley RowHeadersDefaultCellStyle . Al cambiar el Font valor, se actualizan automáticamente las DefaultCellStylepropiedades , ColumnHeadersDefaultCellStyley RowHeadersDefaultCellStyle y se cambia la fuente de cualquier celda que herede el valor. Las celdas de encabezado invalidan el valor de forma predeterminada y puede invalidar el valor de filas, columnas y celdas específicas. Para obtener más información sobre la herencia de estilo de celda, vea Estilos de celda en el control DataGridView de Windows Forms.

Se aplica a