DataGridView.Font Eigenschaft

  • Referenz

Definition

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

Ruft die Schriftart des in der DataGridView angezeigten Texts ab oder legt sie fest.

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

Eigenschaftswert

Font

Der Font, der auf den Text angewendet werden soll, der im Steuerelement angezeigt wird. Der Standardwert ist der Wert der DefaultFont-Eigenschaft.

Attribute
BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft veranschaulicht. Dieses Beispiel ist Teil eines größeren Beispiels, das in "How to" verfügbar ist: Erstellen eines ungebundenen Windows Forms DataGridView-Steuerelements.

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 Umgebungseigenschaft. Eine Umgebungseigenschaft ist eine Steuerelementeigenschaft, die, wenn nicht festgelegt, aus dem übergeordneten Steuerelement abgerufen wird. Beispielsweise hat ein Button Element standardmäßig das gleiche BackColor wie sein übergeordnetes Form Element. Weitere Informationen zu Umgebungseigenschaften finden Sie in der AmbientProperties Klassen- oder Klassenübersicht Control .

Da dies Font unveränderlich ist (d. h. sie können keine der Eigenschaften anpassen), können Sie die Font Eigenschaft nur einem neuen Font Objekt zuweisen. Sie können jedoch die neue Schriftart auf der vorhandenen Schriftart basieren.

Das DataGridView Steuerelement verwendet den Wert der Font Eigenschaft als Standardwert der Eigenschaften DataGridViewCellStyle von Objekten, die Font von der DefaultCellStyleEigenschaft zurückgegeben werden, ColumnHeadersDefaultCellStyleund RowHeadersDefaultCellStyle Eigenschaften. Das Ändern des Font Werts aktualisiert automatisch die DefaultCellStyleColumnHeadersDefaultCellStyleSchriftart und RowHeadersDefaultCellStyle die Eigenschaften und ändert die Schriftart für jede Zelle, die den Wert erbt. Kopfzeilenzellen überschreiben den Wert standardmäßig, und Sie können den Wert für bestimmte Zeilen, Spalten und Zellen außer Kraft setzen. Weitere Informationen zur Vererbung von Zellformatvorlagen finden Sie im Windows Forms DataGridView-Steuerelement.

Gilt für

Siehe auch