Font Class
Defines a particular format for text, including font face, size, and style attributes. This class cannot be inherited.
Assembly: System.Drawing (in System.Drawing.dll)
The Font type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | Font(Font, FontStyle) | Initializes a new Font that uses the specified existing Font and FontStyle enumeration. |
![]() | Font(FontFamily, Single) | Initializes a new Font using a specified size. |
![]() | Font(String, Single) | Initializes a new Font using a specified size. |
![]() | 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 FontStyle::Regular. |
![]() | 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 FontStyle::Regular. |
![]() | Font(FontFamily, Single, FontStyle, GraphicsUnit) | Initializes a new Font using a specified size, style, and unit. |
![]() | Font(String, Single, FontStyle, GraphicsUnit) | Initializes a new Font using a specified size, style, and unit. |
![]() | Font(FontFamily, Single, FontStyle, GraphicsUnit, Byte) | Initializes a new Font using a 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(FontFamily, Single, FontStyle, GraphicsUnit, Byte, Boolean) | Initializes a new Font using a specified size, style, unit, and character set. |
![]() | Font(String, Single, FontStyle, GraphicsUnit, Byte, Boolean) | Initializes a new Font using the specified size, style, unit, and character set. |
| 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 | Infrastructure. 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 true. |
![]() | Underline | Gets a value that indicates whether this Font is underlined. |
![]() | Unit | Gets the unit of measure for this Font. |
| Name | Description | |
|---|---|---|
![]() | Clone | Creates an exact copy of this Font. |
![]() | CreateObjRef | 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 | Indicates whether the specified object is a Font and has the same FontFamily, GdiVerticalFont, GdiCharSet, Style, Size, and Unit property values as this Font. (Overrides Object::Equals(Object).) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() ![]() | FromHdc | Creates a Font from the specified Windows handle to a device context. |
![]() ![]() | FromHfont | Creates a Font from the specified Windows handle. |
![]() ![]() | FromLogFont(Object) | Creates a Font from the specified GDI logical font (LOGFONT) structure. |
![]() ![]() | FromLogFont(Object, IntPtr) | Creates a Font from the specified GDI logical font (LOGFONT) structure. |
![]() | GetHashCode | Gets the hash code for this Font. (Overrides Object::GetHashCode().) |
![]() | 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 | 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 | 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(Object) | Creates a GDI logical font (LOGFONT) structure from this Font. |
![]() | ToLogFont(Object, Graphics) | Creates a GDI logical font (LOGFONT) structure from this Font. |
![]() | ToString | Returns a human-readable string representation of this Font. (Overrides Object::ToString().) |
| Name | Description | |
|---|---|---|
![]() ![]() | ISerializable::GetObjectData | Populates a SerializationInfo with the data needed to serialize the target object. |
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.
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); } }
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
