Compartilhar via

DataGridView.Font Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define a fonte do texto exibido pelo 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 da propriedade

Font

O Font a ser aplicado ao texto exibido pelo controle. O padrão é o valor da propriedade DefaultFont.

Atributos
BrowsableAttribute

Exemplos

O exemplo de código a seguir ilustra o uso dessa propriedade. Este exemplo faz parte de um exemplo maior disponível em 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

Comentários

A Font propriedade é uma propriedade ambiente. Uma propriedade de ambiente é uma propriedade de controle que, se não estiver definida, é recuperada do controle pai. Por exemplo, um Button terá o mesmo BackColor que seu pai Form por padrão. Para obter mais informações sobre propriedades de ambiente, consulte a AmbientProperties classe ou a visão geral da Control classe.

Como é Font imutável (o que significa que você não pode ajustar nenhuma de suas propriedades), você só pode atribuir à Font propriedade um novo Font objeto. No entanto, você pode basear a nova fonte na fonte existente.

O DataGridView controle usa o valor da Font propriedade como o valor padrão das Font propriedades dos DataGridViewCellStyle objetos retornados pelo DefaultCellStyle, ColumnHeadersDefaultCellStylee RowHeadersDefaultCellStyle propriedades. Alterar o Font valor atualiza automaticamente a DefaultCellStyle, ColumnHeadersDefaultCellStylee RowHeadersDefaultCellStyle as propriedades, alterando a fonte para qualquer célula que herda o valor. As células de cabeçalho substituem o valor por padrão e você pode substituir o valor de linhas, colunas e células específicas. Para obter mais informações sobre herança de estilo de célula, consulte Estilos de célula no controle DataGridView dos Windows Forms.

Aplica-se a

Confira também