DataGridView.Font Właściwość

Definicja

Pobiera lub ustawia czcionkę tekstu wyświetlanego przez DataGridView .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; }
[<System.ComponentModel.Browsable(false)>]
member this.Font : System.Drawing.Font with get, set
Public Overrides Property Font As Font

Wartość właściwości

Font

FontDo zastosowania do tekstu wyświetlanego przez kontrolkę.The Font to apply to the text displayed by the control. Wartością domyślną jest wartość DefaultFont właściwości.The default is the value of the DefaultFont property.

Atrybuty

Przykłady

Poniższy przykład kodu ilustruje użycie tej właściwości.The following code example illustrates the use of this property. Ten przykład jest częścią większego przykładu dostępnego w instrukcje: Tworzenie niepowiązanej kontrolki DataGridView Windows Forms.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

Uwagi

FontWłaściwość jest właściwością otoczenia.The Font property is an ambient property. Właściwość otoczenia jest właściwością kontrolki, która jeśli nie jest ustawiona, zostanie pobrana z kontrolki nadrzędnej.An ambient property is a control property that, if not set, is retrieved from the parent control. Na przykład wartość a Button będzie taka sama BackColor jak jej element nadrzędny Form domyślnie.For example, a Button will have the same BackColor as its parent Form by default. Aby uzyskać więcej informacji o właściwościach otoczenia, zobacz AmbientProperties klasy lub Control Przegląd klas.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Ponieważ Font jest niezmienne (oznacza to, że nie można dostosować żadnej z jej właściwości), można przypisać tylko Font Właściwość nowego Font obiektu.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. Można jednak utworzyć nową czcionkę dla istniejącej czcionki.However, you can base the new font on the existing font.

DataGridViewKontrolka używa wartości Font właściwości jako wartości domyślnej Font właściwości DataGridViewCellStyle obiektów zwracanych przez DefaultCellStyle , ColumnHeadersDefaultCellStyle i RowHeadersDefaultCellStyle właściwości.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. Zmiana Font wartości spowoduje automatyczne zaktualizowanie DefaultCellStyle ColumnHeadersDefaultCellStyle właściwości,, i RowHeadersDefaultCellStyle , zmiana czcionki dla każdej komórki, która dziedziczy wartość.Changing the Font value automatically updates the DefaultCellStyle, ColumnHeadersDefaultCellStyle, and RowHeadersDefaultCellStyle properties, changing the font for any cell that inherits the value. Komórki nagłówka przesłaniają domyślnie wartość i można przesłonić wartość dla konkretnych wierszy, kolumn i komórek.Header cells override the value by default, and you can override the value for specific rows, columns, and cells. Aby uzyskać więcej informacji na temat dziedziczenia stylu komórki, zobacz style komórek w kontrolce DataGridView Windows Forms.For more information about cell style inheritance, see Cell Styles in the Windows Forms DataGridView Control.

Dotyczy

Zobacz też