Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
Font Class
Definition
- Namespace:
- System.Drawing
- Assembly:
- System.Drawing.Common.dll
- Assembly:
- System.Drawing.dll
- Package:
- System.Drawing.Common v11.0.0-preview.5.26302.115
- Source:
- Font.cs
- Source:
- Font.cs
- Source:
- Font.cs
- Source:
- Font.cs
- Source:
- Font.cs
- Source:
- Font.cs
- Source:
- Font.cs
- Source:
- Font.cs
- Source:
- Font.cs
Important
Some information relates to prerelease product that may be substantially modified before itβs released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Defines a particular format for text, including font face, size, and style attributes. This class cannot be inherited.
public ref class Font sealed : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.FontConverter))]
[System.Serializable]
public sealed class Font : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.FontConverter))]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Font : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.FontConverter))]
public sealed class Font : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter("System.Drawing.FontConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")]
public sealed class Font : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.FontConverter))>]
[<System.Serializable>]
type Font = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposable
interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.FontConverter))>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Font = class
inherit MarshalByRefObject
interface ICloneable
interface ISerializable
interface IDisposable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.FontConverter))>]
type Font = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposable
interface ISerializable
[<System.ComponentModel.TypeConverter("System.Drawing.FontConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")>]
type Font = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposable
interface ISerializable
Public NotInheritable Class Font
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable
- Inheritance
- Attributes
- Implements
Examples
The following code example demonstrates how to use the Font constructor and the Size, SizeInPoints, and Unit properties. This example is designed to be used with a Windows Form that contains a ComboBox named ComboBox1 that is populated with the strings "Bigger" and "Smaller" and a Label named Label1. Paste the following code into the form and associate the ComboBox1_SelectedIndexChanged method with the SelectedIndexChanged event of the ComboBox control.
private:
void ComboBox1_SelectedIndexChanged(System::Object^ sender,
System::EventArgs^ e)
{
// Cast the sender object back to a ComboBox.
ComboBox^ ComboBox1 = (ComboBox^) sender;
// Retrieve the selected item.
String^ selectedString = (String^) ComboBox1->SelectedItem;
// Convert it to lowercase.
selectedString = selectedString->ToLower();
// Declare the current size.
float currentSize;
// If Bigger is selected, get the current size from the
// Size property and increase it. Reset the font to the
// new size, using the current unit.
if (selectedString == "bigger")
{
currentSize = Label1->Font->Size;
currentSize += 2.0F;
Label1->Font =gcnew System::Drawing::Font(Label1->Font->Name,
currentSize, Label1->Font->Style, Label1->Font->Unit);
}
// If Smaller is selected, get the current size, in
// points, and decrease it by 2. Reset the font with
// the new size in points.
if (selectedString == "smaller")
{
currentSize = Label1->Font->Size;
currentSize -= 2.0F;
Label1->Font = gcnew System::Drawing::Font(Label1->Font->Name,
currentSize, Label1->Font->Style);
}
}
private void ComboBox1_SelectedIndexChanged(System.Object sender,
System.EventArgs e)
{
// Cast the sender object back to a ComboBox.
ComboBox ComboBox1 = (ComboBox) sender;
// Retrieve the selected item.
string selectedString = (string) ComboBox1.SelectedItem;
// Convert it to lowercase.
selectedString = selectedString.ToLower();
// Declare the current size.
float currentSize;
// Switch on the selected item.
switch(selectedString)
{
// If Bigger is selected, get the current size from the
// Size property and increase it. Reset the font to the
// new size, using the current unit.
case "bigger":
currentSize = Label1.Font.Size;
currentSize += 2.0F;
Label1.Font = new Font(Label1.Font.Name, currentSize,
Label1.Font.Style, Label1.Font.Unit);
// If Smaller is selected, get the current size, in points,
// and decrease it by 1. Reset the font with the new size
// in points.
break;
case "smaller":
currentSize = Label1.Font.SizeInPoints;
currentSize -= 1;
Label1.Font = new Font(Label1.Font.Name, currentSize,
Label1.Font.Style);
break;
}
}
Private Sub ComboBox1_SelectedIndexChanged(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles ComboBox1.SelectedIndexChanged
' Cast the sender object back to a ComboBox.
Dim ComboBox1 As ComboBox = CType(sender, ComboBox)
' Retrieve the selected item.
Dim selectedString As String = CType(ComboBox1.SelectedItem, String)
' Convert it to lowercase.
selectedString = selectedString.ToLower()
' Declare the current size.
Dim currentSize As Single
' Switch on the selected item.
Select Case selectedString
' If Bigger is selected, get the current size from the
' Size property and increase it. Reset the font to the
' new size, using the current unit.
Case "bigger"
currentSize = Label1.Font.Size
currentSize += 2.0F
Label1.Font = New Font(Label1.Font.Name, currentSize, _
Label1.Font.Style, Label1.Font.Unit)
' If Smaller is selected, get the current size, in points,
' and decrease it by 1. Reset the font with the new size
' in points.
Case "smaller"
currentSize = Label1.Font.SizeInPoints
currentSize -= 1
Label1.Font = New Font(Label1.Font.Name, currentSize, _
Label1.Font.Style)
End Select
End Sub
Remarks
For more information about how to construct fonts, see How to: Construct Font Families and Fonts. Windows Forms applications support TrueType fonts and have limited support for OpenType fonts. If you attempt to use a font that is not supported, or the font is not installed on the machine that is running the application, the Microsoft Sans Serif font will be substituted.
Note
In .NET 6 and later versions, the System.Drawing.Common package, which includes this type, is only supported on Windows operating systems. Use of this type in cross-platform apps causes compile-time warnings and run-time exceptions. For more information, see System.Drawing.Common only supported on Windows.
Constructors
| Name | Description |
|---|---|
| Font(Font, FontStyle) |
Initializes a new Font that uses the specified existing Font and FontStyle enumeration. |
| Font(FontFamily, Single, FontStyle, GraphicsUnit, Byte, Boolean) |
Initializes a new Font using a specified size, style, unit, and character set. |
| Font(FontFamily, Single, FontStyle, GraphicsUnit, Byte) |
Initializes a new Font using a specified size, style, unit, and character set. |
| Font(FontFamily, Single, FontStyle, GraphicsUnit) |
Initializes a new Font using a specified size, style, and unit. |
| Font(FontFamily, Single, FontStyle) |
Initializes a new Font using a specified size and style. |
| Font(FontFamily, Single, GraphicsUnit) |
Initializes a new Font using a specified size and unit. Sets the style to Regular. |
| Font(FontFamily, Single) |
Initializes a new Font using a specified size. |
| Font(String, Single, FontStyle, GraphicsUnit, Byte, Boolean) |
Initializes a new Font using the specified size, style, unit, and character set. |
| Font(String, Single, FontStyle, GraphicsUnit, Byte) |
Initializes a new Font using a specified size, style, unit, and character set. |
| Font(String, Single, FontStyle, GraphicsUnit) |
Initializes a new Font using a specified size, style, and unit. |
| Font(String, Single, FontStyle) |
Initializes a new Font using a specified size and style. |
| Font(String, Single, GraphicsUnit) |
Initializes a new Font using a specified size and unit. The style is set to Regular. |
| Font(String, Single) |
Initializes a new Font using a specified size. |
Properties
| Name | Description |
|---|---|
| Bold |
Gets a value that indicates whether this Font is bold. |
| FontFamily |
Gets the FontFamily associated with this Font. |
| GdiCharSet |
Gets a byte value that specifies the GDI character set that this Font uses. |
| GdiVerticalFont |
Gets a Boolean value that indicates whether this Font is derived from a GDI vertical font. |
| Height |
Gets the line spacing of this font. |
| IsSystemFont |
Gets a value indicating whether the font is a member of SystemFonts. |
| Italic |
Gets a value that indicates whether this font has the italic style applied. |
| Name |
Gets the face name of this Font. |
| OriginalFontName |
Gets the name of the font originally specified. |
| Size |
Gets the em-size of this Font measured in the units specified by the Unit property. |
| SizeInPoints |
Gets the em-size, in points, of this Font. |
| Strikeout |
Gets a value that indicates whether this Font specifies a horizontal line through the font. |
| Style |
Gets style information for this Font. |
| SystemFontName |
Gets the name of the system font if the IsSystemFont property returns |
| Underline |
Gets a value that indicates whether this Font is underlined. |
| Unit |
Gets the unit of measure for this Font. |
Methods
| Name | Description |
|---|---|
| Clone() |
Creates an exact copy of this Font. |
| CreateObjRef(Type) |
Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject) |
| Dispose() |
Releases all resources used by this Font. |
| Equals(Object) |
Indicates whether the specified object is a Font and has the same FontFamily, GdiVerticalFont, GdiCharSet, Style, Size, and Unit property values as this Font. |
| Finalize() |
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. |
| FromHdc(IntPtr) |
Creates a Font from the specified Windows handle to a device context. |
| FromHfont(IntPtr) |
Creates a Font from the specified Windows handle. |
| FromLogFont(LOGFONT, IntPtr) | |
| FromLogFont(LOGFONT) | |
| FromLogFont(Object, IntPtr) |
Creates a Font from the specified GDI logical font ( |
| FromLogFont(Object) |
Creates a Font from the specified GDI logical font ( |
| GetHashCode() |
Gets the hash code for this Font. |
| GetHeight() |
Returns the line spacing, in pixels, of this font. |
| GetHeight(Graphics) |
Returns the line spacing, in the current unit of a specified Graphics, of this font. |
| GetHeight(Single) |
Returns the height, in pixels, of this Font when drawn to a device with the specified vertical resolution. |
| GetLifetimeService() |
Obsolete.
Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject) |
| GetType() |
Gets the Type of the current instance. (Inherited from Object) |
| InitializeLifetimeService() |
Obsolete.
Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject) |
| MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
| MemberwiseClone(Boolean) |
Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject) |
| ToHfont() |
Returns a handle to this Font. |
| ToLogFont(LOGFONT, Graphics) | |
| ToLogFont(LOGFONT) | |
| ToLogFont(Object, Graphics) |
Creates a GDI logical font ( |
| ToLogFont(Object) |
Creates a GDI logical font ( |
| ToString() |
Returns a human-readable string representation of this Font. |
Explicit Interface Implementations
| Name | Description |
|---|---|
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Populates a SerializationInfo with the data needed to serialize the target object. |
Applies to
See also
Feedback
Was this page helpful?
