DataGridView.Font DataGridView.Font DataGridView.Font DataGridView.Font Property

Definition

Ruft die Schriftart des in der DataGridView angezeigten Texts ab oder legt sie fest.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

Eigenschaftswert

Der Font, der auf den Text angewendet werden soll, der im Steuerelement angezeigt wird.The Font to apply to the text displayed by the control. Der Standardwert ist der Wert der DefaultFont-Eigenschaft.The default is the value of the DefaultFont property.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft veranschaulicht.The following code example illustrates the use of this property. Dieses Beispiel ist Teil eines größeren Beispiels, das unter Vorgehensweise: Erstellen Sie ein ungebundenes Windows Forms DataGridView-SteuerElement.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

Hinweise

Die Font -Eigenschaft ist eine Ambient-Eigenschaft.The Font property is an ambient property. Eine Ambient-Eigenschaft ist eine Steuerelement Eigenschaft, die, wenn Sie nicht festgelegt ist, vom übergeordneten Steuerelement abgerufen wird.An ambient property is a control property that, if not set, is retrieved from the parent control. Beispielsweise hat ein Button standardmäßig dasselbe BackColor wie das übergeordnete Form Element.For example, a Button will have the same BackColor as its parent Form by default. Weitere Informationen zu Ambient-Eigenschaften finden Sie unter AmbientProperties der-Klasse Control oder der-Klassen Übersicht.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Da der Font unveränderlich ist (d. h., Sie können keine seiner Eigenschaften anpassen), können Sie die Font Eigenschaft nur einem neuen Font Objekt zuweisen.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. Allerdings können Sie die neue Schriftart auf der vorhandenen Schriftart basieren.However, you can base the new font on the existing font.

Das DataGridView -Steuerelement verwendet den Wert Font der-Eigenschaft als Standardwert für Font die Eigenschaften DataGridViewCellStyle von-Objekten, DefaultCellStyledie ColumnHeadersDefaultCellStylevon den RowHeadersDefaultCellStyle Eigenschaften, und zurückgegeben werden.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. Wenn Sie Font den Wert ändern, DefaultCellStylewerden ColumnHeadersDefaultCellStyledie Eigenschaften RowHeadersDefaultCellStyle , und automatisch aktualisiert, und die Schriftart für jede Zelle, die den Wert erbt, wird geändert.Changing the Font value automatically updates the DefaultCellStyle, ColumnHeadersDefaultCellStyle, and RowHeadersDefaultCellStyle properties, changing the font for any cell that inherits the value. Header Zellen überschreiben standardmäßig den Wert, und Sie können den Wert für bestimmte Zeilen, Spalten und Zellen überschreiben.Header cells override the value by default, and you can override the value for specific rows, columns, and cells. Weitere Informationen zur Vererbung von Zellen Formaten finden Sie unter Zellen Stile im Windows Forms DataGridView-SteuerElement.For more information about cell style inheritance, see Cell Styles in the Windows Forms DataGridView Control.

Gilt für:

Siehe auch