Export (0) Print
Expand All
Expand Minimize

Control.Font Property

Gets or sets the font of the text displayed by the control.

[Visual Basic]
Public Overridable Property Font As Font
[C#]
public virtual Font Font {get; set;}
[C++]
public: __property virtual Font* get_Font();
public: __property virtual void set_Font(Font*);
[JScript]
public function get Font() : Font;
public function set Font(Font);

Property Value

The Font object to apply to the text displayed by the control. The default is the value of the DefaultFont property.

Remarks

The Font property is an ambient property. An ambient property is a control property that, if not set, is retrieved from the parent control. For example, a Button will have the same BackColor as its parent Form by default. For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Because the Font object is immutable (meaning that you cannot adjust any of it's properties), you can only assign the Font property a new Font object. However, you can base the new font on the existing font.

[Visual Basic, C#] The following is an example of how to adjust the existing font to make it bold:

[C#] 
myControl.Font = new Font(myControl.Font, 
   myControl.Font.Style | FontStyle.Bold);
[Visual Basic] 
MyControl.Font = New Font(MyControl.Font, _ 
   MyControl.Font.Style Or FontStyle.Bold)

Notes to Inheritors:  When overriding the Font property in a derived class, use the base class's Font property to extend the base implementation. Otherwise, you must provide all the implementation. You are not required to override both the get and set accessors of the Font property; you can override only one if needed.

Example

[Visual Basic, C#, C++] The following example displays a FontDialog to the user and changes the Font of a DateTimePicker control. This example assumes you have a Form with Button and a DateTimePicker on it.

[Visual Basic] 
Private Sub myButton_Click(sender As Object, e As EventArgs)
   Dim myFontDialog As FontDialog
   myFontDialog = New FontDialog()
   
   If myFontDialog.ShowDialog() = DialogResult.OK Then
      ' Set the control's font.
      myDateTimePicker.Font = myFontDialog.Font
   End If
End Sub

[C#] 
private void myButton_Click(object sender, EventArgs e)
{
   FontDialog myFontDialog = new FontDialog();
   if(myFontDialog.ShowDialog() == DialogResult.OK)
   {
      // Set the control's font.
      myDateTimePicker.Font = myFontDialog.Font;
   }
}

[C++] 
private:
    void myButton_Click(Object* /*sender*/, EventArgs* /*e*/) {
        FontDialog* myFontDialog = new FontDialog();
        if (myFontDialog->ShowDialog() == DialogResult::OK) {
            // Set the control's font.
            myDateTimePicker->Font = myFontDialog->Font;
        }
    }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

Control Class | Control Members | System.Windows.Forms Namespace | FontChanged | OnFontChanged | Font

Show:
© 2015 Microsoft