Font Constructor (String, Single, FontStyle, GraphicsUnit, Byte)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Initializes a new Font using a specified size, style, unit, and character set.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

new : 
        familyName:string *
        emSize:float32 *
        style:FontStyle *
        unit:GraphicsUnit *
        gdiCharSet:byte -> Font

Parameters

familyName
Type: System.String

A string representation of the FontFamily for the new Font.

emSize
Type: System.Single

The em-size of the new font in the units specified by the unit parameter.

style
Type: System.Drawing.FontStyle

The FontStyle of the new font.

unit
Type: System.Drawing.GraphicsUnit

The GraphicsUnit of the new font.

gdiCharSet
Type: System.Byte

A Byte that specifies a GDI character set to use for this font.

Exception Condition
ArgumentException

emSize is less than or equal to 0, evaluates to infinity, or is not a valid number.

The gdiCharSet parameter takes a value from the list defined in the Windows SDK header file WinGDI.h. Windows Forms applications support TrueType fonts and have limited support for OpenType fonts. If the familyName parameter specifies a font that is not installed on the machine running the application or is not supported, Microsoft Sans Serif will be substituted.

.NET Framework
Available since 1.1
Return to top
Show: