DataGridView.Font Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridView.cs

Obtient ou définit la police du texte affiché par le 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

Valeur de propriété

Font

À Font appliquer au texte affiché par le contrôle. La valeur par défaut est la valeur de la DefaultFont propriété.

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de cette propriété. Cet exemple fait partie d’un exemple plus large disponible dans 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

Remarques

La Font propriété est une propriété ambiante. Une propriété ambiante est une propriété de contrôle qui, si elle n’est pas définie, est récupérée à partir du contrôle parent. Par exemple, une Button valeur aura la même BackColor valeur que son parent Form par défaut. Pour plus d’informations sur les propriétés ambiantes, consultez la AmbientProperties classe ou la vue d’ensemble de la Control classe.

Étant donné que le paramètre Font est immuable (ce qui signifie que vous ne pouvez pas ajuster ses propriétés), vous ne pouvez affecter la Font propriété qu’un nouvel Font objet. Toutefois, vous pouvez baser la nouvelle police sur la police existante.

Le DataGridView contrôle utilise la valeur de la Font propriété comme valeur par défaut des Font propriétés des DataGridViewCellStyle objets retournés par les DefaultCellStylepropriétés , ColumnHeadersDefaultCellStyleet RowHeadersDefaultCellStyle les propriétés. La modification de la Font valeur met automatiquement à jour les propriétés et RowHeadersDefaultCellStyle les DefaultCellStylepropriétésColumnHeadersDefaultCellStyle, en modifiant la police pour n’importe quelle cellule qui hérite de la valeur. Les cellules d’en-tête remplacent la valeur par défaut, et vous pouvez remplacer la valeur pour des lignes, des colonnes et des cellules spécifiques. Pour plus d’informations sur l’héritage de style de cellule, consultez Styles de cellule dans le contrôle DataGridView Windows Forms.

Voir aussi

• DefaultCellStyle
• ColumnHeadersDefaultCellStyle
• RowHeadersDefaultCellStyle
• DataGridViewCellStyle
• Font
• Font
• Styles de cellule dans le contrôle DataGridView Windows Forms
• DataGridView Control (Windows Forms)