Font 构造函数

参考

定义

命名空间:: System.Drawing

程序集:: System.Drawing.Common.dll

程序集:: System.Drawing.dll

包:: System.Drawing.Common v8.0.8

包:: System.Drawing.Common v9.0.0-rc.1.24451.1

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

初始化使用指定现有 Font 和 FontStyle的新 Font。

重载

Font(Font, FontStyle)	初始化使用指定的现有 Font 和 FontStyle 枚举的新 Font。
Font(String, Single, FontStyle, GraphicsUnit, Byte, Boolean)	使用指定的大小、样式、单元和字符集初始化新的 Font。
Font(FontFamily, Single, FontStyle, GraphicsUnit, Byte, Boolean)	使用指定的大小、样式、单位和字符集初始化新的 Font。
Font(FontFamily, Single, FontStyle, GraphicsUnit, Byte)	使用指定的大小、样式、单位和字符集初始化新的 Font。
Font(String, Single, FontStyle, GraphicsUnit)	使用指定的大小、样式和单位初始化新的 Font。
Font(FontFamily, Single, FontStyle, GraphicsUnit)	使用指定的大小、样式和单位初始化新的 Font。
Font(String, Single, FontStyle, GraphicsUnit, Byte)	使用指定的大小、样式、单位和字符集初始化新的 Font。
Font(String, Single, FontStyle)	使用指定的大小和样式初始化新的 Font。
Font(FontFamily, Single, GraphicsUnit)	使用指定的大小和单位初始化新的 Font。将样式设置为 Regular。
Font(FontFamily, Single, FontStyle)	使用指定的大小和样式初始化新的 Font。
Font(String, Single)	使用指定的大小初始化新的 Font。
Font(FontFamily, Single)	使用指定的大小初始化新的 Font。
Font(String, Single, GraphicsUnit)	使用指定的大小和单位初始化新的 Font。样式设置为 Regular。

Font(Font, FontStyle)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

初始化使用指定的现有 Font 和 FontStyle 枚举的新 Font。

public:
 Font(System::Drawing::Font ^ prototype, System::Drawing::FontStyle newStyle);

public Font (System.Drawing.Font prototype, System.Drawing.FontStyle newStyle);

new System.Drawing.Font : System.Drawing.Font * System.Drawing.FontStyle -> System.Drawing.Font

Public Sub New (prototype As Font, newStyle As FontStyle)

参数

prototype: Font

要从中创建新 Font的现有 Font。

newStyle: FontStyle

要应用于新 Font的 FontStyle。 FontStyle 枚举的多个值可以与 OR 运算符结合使用。

示例

下面的代码示例演示 Inequality 运算符、Font 构造函数和 Bold 属性。此示例旨在与包含名为 Button2按钮的 Windows 窗体一起使用。将以下代码粘贴到窗体中，并将 Button2_Click 方法与按钮的 Click 事件相关联。

void Button2_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   if ( this->BackColor != SystemColors::ControlDark )
   {
      this->BackColor = SystemColors::ControlDark;
   }

   if (  !(this->Font->Bold) )
   {
      this->Font = gcnew System::Drawing::Font( this->Font,FontStyle::Bold );
   }
}

private void Button2_Click(System.Object sender, System.EventArgs e)
{

    if (this.BackColor != SystemColors.ControlDark)
    {
        this.BackColor = SystemColors.ControlDark;
    }
    if (!(this.Font.Bold))
    {
        this.Font = new Font(this.Font, FontStyle.Bold);
    }
}

Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button2.Click

    If (Color.op_Inequality(Me.BackColor, SystemColors.ControlDark)) Then
        Me.BackColor = SystemColors.ControlDark
    End If
    If Not (Me.Font.Bold) Then
        Me.Font = New Font(Me.Font, FontStyle.Bold)
    End If
End Sub

注解

对于基于 .NET Framework 2.0 及更早版本的本地化应用程序，在用于生成应用程序的计算机上未安装该字体时，指定用于 prototype 的字体将导致改用 Microsoft Sans Serif 字体。如果应用程序依赖于此行为，并且必须为 .NET Framework 3.0 重新编译应用程序，则应为 prototype指定 Microsoft Sans Serif 字体。

适用于

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

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小、样式、单元和字符集初始化新的 Font。

public:
 Font(System::String ^ familyName, float emSize, System::Drawing::FontStyle style, System::Drawing::GraphicsUnit unit, System::Byte gdiCharSet, bool gdiVerticalFont);

public Font (string familyName, float emSize, System.Drawing.FontStyle style, System.Drawing.GraphicsUnit unit, byte gdiCharSet, bool gdiVerticalFont);

new System.Drawing.Font : string * single * System.Drawing.FontStyle * System.Drawing.GraphicsUnit * byte * bool -> System.Drawing.Font

Public Sub New (familyName As String, emSize As Single, style As FontStyle, unit As GraphicsUnit, gdiCharSet As Byte, gdiVerticalFont As Boolean)

参数

familyName: String

新 Font的 FontFamily 的字符串表示形式。

emSize: Single

由 unit 参数指定的单位中新字体的 em 大小。

style: FontStyle

新字体 FontStyle。

unit: GraphicsUnit

新字体 GraphicsUnit。

gdiCharSet: Byte

指定要用于此字体的 GDI 字符集的 Byte。

gdiVerticalFont: Boolean

一个布尔值，该值指示新 Font 是否派生自 GDI 垂直字体。

例外

ArgumentException

emSize 小于或等于 0、计算结果为无穷大或无效的数字。

注解

gdiCharSet 参数从 Windows SDK 头文件 WinGDI.h 中定义的列表中获取值。如果 familyName 参数指定未安装在运行应用程序或不支持的计算机上安装的字体，则Microsoft Sans Serif 将被替换。

另请参阅

GdiCharSet

适用于

Font(FontFamily, Single, FontStyle, GraphicsUnit, Byte, Boolean)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小、样式、单位和字符集初始化新的 Font。

public:
 Font(System::Drawing::FontFamily ^ family, float emSize, System::Drawing::FontStyle style, System::Drawing::GraphicsUnit unit, System::Byte gdiCharSet, bool gdiVerticalFont);

public Font (System.Drawing.FontFamily family, float emSize, System.Drawing.FontStyle style, System.Drawing.GraphicsUnit unit, byte gdiCharSet, bool gdiVerticalFont);

new System.Drawing.Font : System.Drawing.FontFamily * single * System.Drawing.FontStyle * System.Drawing.GraphicsUnit * byte * bool -> System.Drawing.Font

Public Sub New (family As FontFamily, emSize As Single, style As FontStyle, unit As GraphicsUnit, gdiCharSet As Byte, gdiVerticalFont As Boolean)

参数

family: FontFamily

新 Font的 FontFamily。

emSize: Single

由 unit 参数指定的单位中新字体的 em 大小。

style: FontStyle

新字体 FontStyle。

unit: GraphicsUnit

新字体 GraphicsUnit。

gdiCharSet: Byte

指定 Byte

要用于此字体的 GDI 字符集。

gdiVerticalFont: Boolean

一个布尔值，该值指示新字体是否派生自 GDI 垂直字体。

例外

ArgumentException

emSize 小于或等于 0、计算结果为无穷大或无效的数字。

ArgumentNullException

family null

注解

gdiCharSet 参数从 Windows SDK 头文件 WinGDI.h 中定义的列表中获取值。

适用于

Font(FontFamily, Single, FontStyle, GraphicsUnit, Byte)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小、样式、单位和字符集初始化新的 Font。

public:
 Font(System::Drawing::FontFamily ^ family, float emSize, System::Drawing::FontStyle style, System::Drawing::GraphicsUnit unit, System::Byte gdiCharSet);

public Font (System.Drawing.FontFamily family, float emSize, System.Drawing.FontStyle style, System.Drawing.GraphicsUnit unit, byte gdiCharSet);

new System.Drawing.Font : System.Drawing.FontFamily * single * System.Drawing.FontStyle * System.Drawing.GraphicsUnit * byte -> System.Drawing.Font

Public Sub New (family As FontFamily, emSize As Single, style As FontStyle, unit As GraphicsUnit, gdiCharSet As Byte)

参数

family: FontFamily

新 Font的 FontFamily。

emSize: Single

由 unit 参数指定的单位中新字体的 em 大小。

style: FontStyle

新字体 FontStyle。

unit: GraphicsUnit

新字体 GraphicsUnit。

gdiCharSet: Byte

指定 Byte

要用于新字体的 GDI 字符集。

例外

ArgumentException

emSize 小于或等于 0、计算结果为无穷大或无效的数字。

ArgumentNullException

family null。

注解

gdiCharSet 参数从 Windows SDK 头文件 WinGDI.h 中定义的列表中获取值。

适用于

Font(String, Single, FontStyle, GraphicsUnit)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小、样式和单位初始化新的 Font。

public:
 Font(System::String ^ familyName, float emSize, System::Drawing::FontStyle style, System::Drawing::GraphicsUnit unit);

public Font (string familyName, float emSize, System.Drawing.FontStyle style, System.Drawing.GraphicsUnit unit);

new System.Drawing.Font : string * single * System.Drawing.FontStyle * System.Drawing.GraphicsUnit -> System.Drawing.Font

Public Sub New (familyName As String, emSize As Single, style As FontStyle, unit As GraphicsUnit)

参数

familyName: String

新 Font的 FontFamily 的字符串表示形式。

emSize: Single

由 unit 参数指定的单位中新字体的 em 大小。

style: FontStyle

新字体 FontStyle。

unit: GraphicsUnit

新字体 GraphicsUnit。

例外

ArgumentException

emSize 小于或等于 0，计算结果为无穷大或无效数字。

示例

下面的代码示例演示如何使用 Font 构造函数。此示例旨在与 Windows 窗体一起使用。若要运行此示例，请将此代码粘贴到包含名为 Button2的按钮的窗体中，并将 Button2_Click 方法与按钮的 Click 事件相关联。


private:
    void Button2_Click(System::Object^ sender,
        System::EventArgs^ e)
    {
        Button2->Font = gcnew System::Drawing::Font
            (FontFamily::GenericMonospace, 12.0F,
            FontStyle::Italic, GraphicsUnit::Pixel);
    }


private void Button2_Click(System.Object sender, System.EventArgs e)
{

    Button2.Font = new Font(FontFamily.GenericMonospace, 12.0F, 
        FontStyle.Italic, GraphicsUnit.Pixel);
}


Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button2.Click

    Button2.Font = New Font(FontFamily.GenericMonospace, 12.0F, _
        FontStyle.Italic, GraphicsUnit.Pixel)

End Sub

注解

Windows 窗体应用程序支持 TrueType 字体，并且对 OpenType 字体的支持有限。如果 familyName 参数指定未安装在运行应用程序或不支持的计算机上安装的字体，则Microsoft Sans Serif 将被替换。

适用于

Font(FontFamily, Single, FontStyle, GraphicsUnit)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小、样式和单位初始化新的 Font。

public:
 Font(System::Drawing::FontFamily ^ family, float emSize, System::Drawing::FontStyle style, System::Drawing::GraphicsUnit unit);

public Font (System.Drawing.FontFamily family, float emSize, System.Drawing.FontStyle style, System.Drawing.GraphicsUnit unit);

new System.Drawing.Font : System.Drawing.FontFamily * single * System.Drawing.FontStyle * System.Drawing.GraphicsUnit -> System.Drawing.Font

Public Sub New (family As FontFamily, emSize As Single, style As FontStyle, unit As GraphicsUnit)

参数

family: FontFamily

新 Font的 FontFamily。

emSize: Single

由 unit 参数指定的单位中新字体的 em 大小。

style: FontStyle

新字体 FontStyle。

unit: GraphicsUnit

新字体 GraphicsUnit。

例外

ArgumentException

emSize 小于或等于 0、计算结果为无穷大或无效的数字。

ArgumentNullException

family null。

适用于

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

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小、样式、单位和字符集初始化新的 Font。

public:
 Font(System::String ^ familyName, float emSize, System::Drawing::FontStyle style, System::Drawing::GraphicsUnit unit, System::Byte gdiCharSet);

public Font (string familyName, float emSize, System.Drawing.FontStyle style, System.Drawing.GraphicsUnit unit, byte gdiCharSet);

new System.Drawing.Font : string * single * System.Drawing.FontStyle * System.Drawing.GraphicsUnit * byte -> System.Drawing.Font

Public Sub New (familyName As String, emSize As Single, style As FontStyle, unit As GraphicsUnit, gdiCharSet As Byte)

参数

familyName: String

新 Font的 FontFamily 的字符串表示形式。

emSize: Single

由 unit 参数指定的单位中新字体的 em 大小。

style: FontStyle

新字体 FontStyle。

unit: GraphicsUnit

新字体 GraphicsUnit。

gdiCharSet: Byte

指定要用于此字体的 GDI 字符集的 Byte。

例外

ArgumentException

emSize 小于或等于 0、计算结果为无穷大或无效的数字。

注解

gdiCharSet 参数从 Windows SDK 头文件 WinGDI.h 中定义的列表中获取值。 Windows 窗体应用程序支持 TrueType 字体，并且对 OpenType 字体的支持有限。如果 familyName 参数指定未安装在运行应用程序或不支持的计算机上安装的字体，则Microsoft Sans Serif 将被替换。

另请参阅

GdiCharSet

适用于

Font(String, Single, FontStyle)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小和样式初始化新的 Font。

public:
 Font(System::String ^ familyName, float emSize, System::Drawing::FontStyle style);

public Font (string familyName, float emSize, System.Drawing.FontStyle style);

new System.Drawing.Font : string * single * System.Drawing.FontStyle -> System.Drawing.Font

Public Sub New (familyName As String, emSize As Single, style As FontStyle)

参数

familyName: String

新 Font的 FontFamily 的字符串表示形式。

emSize: Single

新字体的 em 大小（以磅为单位）。

style: FontStyle

新字体 FontStyle。

例外

ArgumentException

emSize 小于或等于 0、计算结果为无穷大或无效的数字。

注解

生成的字体 Unit 属性设置为 Point。 Windows 窗体应用程序支持 TrueType 字体，并且对 OpenType 字体的支持有限。如果 familyName 参数指定未安装在运行应用程序或不支持的计算机上安装的字体，则Microsoft Sans Serif 将被替换。

适用于

Font(FontFamily, Single, GraphicsUnit)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小和单位初始化新的 Font。将样式设置为 Regular。

public:
 Font(System::Drawing::FontFamily ^ family, float emSize, System::Drawing::GraphicsUnit unit);

public Font (System.Drawing.FontFamily family, float emSize, System.Drawing.GraphicsUnit unit);

new System.Drawing.Font : System.Drawing.FontFamily * single * System.Drawing.GraphicsUnit -> System.Drawing.Font

Public Sub New (family As FontFamily, emSize As Single, unit As GraphicsUnit)

参数

family: FontFamily

新 Font的 FontFamily。

emSize: Single

由 unit 参数指定的单位中新字体的 em 大小。

unit: GraphicsUnit

新字体 GraphicsUnit。

例外

ArgumentNullException

family null。

ArgumentException

emSize 小于或等于 0、计算结果为无穷大或无效的数字。

注解

生成的字体 Style 属性设置为 FontStyle.Regular。

适用于

Font(FontFamily, Single, FontStyle)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小和样式初始化新的 Font。

public:
 Font(System::Drawing::FontFamily ^ family, float emSize, System::Drawing::FontStyle style);

public Font (System.Drawing.FontFamily family, float emSize, System.Drawing.FontStyle style);

new System.Drawing.Font : System.Drawing.FontFamily * single * System.Drawing.FontStyle -> System.Drawing.Font

Public Sub New (family As FontFamily, emSize As Single, style As FontStyle)

参数

family: FontFamily

新 Font的 FontFamily。

emSize: Single

新字体的 em 大小（以磅为单位）。

style: FontStyle

新字体 FontStyle。

例外

ArgumentException

emSize 小于或等于 0、计算结果为无穷大或无效的数字。

ArgumentNullException

family null。

示例

下面的代码示例演示如何将按钮的 Font 属性设置为新的粗体样式 Font。此示例旨在与包含名为 Button1按钮的 Windows 窗体一起使用。将以下代码粘贴到窗体中，并将 Button1_Click 方法与按钮的 Click 事件相关联。

private:
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Button1->Font = gcnew System::Drawing::Font( FontFamily::GenericSansSerif,12.0F,FontStyle::Bold );
   }

private void Button1_Click(System.Object sender, System.EventArgs e)
{
    if (Button1.Font.Style != FontStyle.Bold)
            Button1.Font = new Font(FontFamily.GenericSansSerif,
            12.0F, FontStyle.Bold);
}

 Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click
    If Not Button1.Font.Style = FontStyle.Bold Then
        Button1.Font = New Font(FontFamily.GenericSansSerif, _
            12.0F, FontStyle.Bold)
    End If
End Sub

注解

生成的字体 Unit 属性设置为 Point。

适用于

Font(String, Single)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小初始化新的 Font。

public:
 Font(System::String ^ familyName, float emSize);

public Font (string familyName, float emSize);

new System.Drawing.Font : string * single -> System.Drawing.Font

Public Sub New (familyName As String, emSize As Single)

参数

familyName: String

新 Font的 FontFamily 的字符串表示形式。

emSize: Single

新字体的 em 大小（以磅为单位）。

例外

ArgumentException

emSize 小于或等于 0，计算结果为无穷大或无效数字。

示例

下面的代码示例演示如何使用 Font 构造函数。此示例旨在与 Windows 窗体一起使用，需要一个 PaintEventArgse，这是 Paint 事件的参数。

private void ConstructFontWithString(PaintEventArgs e)
{
    Font font1 = new Font("Arial", 20);
    e.Graphics.DrawString("Arial Font", font1, Brushes.Red, new PointF(10, 10));
}

Private Sub ConstructFontWithString(ByVal e As PaintEventArgs)
    Dim font1 As New Font("Arial", 20)
    e.Graphics.DrawString("Arial Font", font1, Brushes.Red, New PointF(10, 10))
End Sub

注解

生成的字体 Style 属性设置为 FontStyle.Regular，其 Unit 属性设置为 GraphicsUnit.Point。 Windows 窗体应用程序支持 TrueType 字体，并且对 OpenType 字体的支持有限。如果 familyName 参数指定未安装在运行应用程序或不支持的计算机上安装的字体，则Microsoft Sans Serif 将被替换。

适用于

Font(FontFamily, Single)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小初始化新的 Font。

public:
 Font(System::Drawing::FontFamily ^ family, float emSize);

public Font (System.Drawing.FontFamily family, float emSize);

new System.Drawing.Font : System.Drawing.FontFamily * single -> System.Drawing.Font

Public Sub New (family As FontFamily, emSize As Single)

参数

family: FontFamily

新 Font的 FontFamily。

emSize: Single

新字体的 em 大小（以磅为单位）。

例外

ArgumentException

emSize 小于或等于 0、计算结果为无穷大或无效的数字。

注解

生成的字体 Style 属性设置为 Regular，其 Unit 属性设置为 Point。

适用于

Font(String, Single, GraphicsUnit)

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

Source:: Font.cs

使用指定的大小和单位初始化新的 Font。样式设置为 Regular。

public:
 Font(System::String ^ familyName, float emSize, System::Drawing::GraphicsUnit unit);

public Font (string familyName, float emSize, System.Drawing.GraphicsUnit unit);

new System.Drawing.Font : string * single * System.Drawing.GraphicsUnit -> System.Drawing.Font

Public Sub New (familyName As String, emSize As Single, unit As GraphicsUnit)

参数

familyName: String

新 Font的 FontFamily 的字符串表示形式。

emSize: Single

由 unit 参数指定的单位中新字体的 em 大小。

unit: GraphicsUnit

新字体 GraphicsUnit。

例外

ArgumentException

emSize 小于或等于 0、计算结果为无穷大或无效的数字。

注解

生成的字体 Style 属性设置为 FontStyle.Regular。

适用于

通过

Font 构造函数

定义

重载

Font(Font, FontStyle)

参数

示例

注解

适用于

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

参数

例外

注解

另请参阅

适用于

Font(FontFamily, Single, FontStyle, GraphicsUnit, Byte, Boolean)

参数

例外

注解

适用于

Font(FontFamily, Single, FontStyle, GraphicsUnit, Byte)

参数

例外

注解

适用于

Font(String, Single, FontStyle, GraphicsUnit)

参数

例外

示例

注解

适用于

Font(FontFamily, Single, FontStyle, GraphicsUnit)

参数

例外

适用于

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

参数

例外

注解

另请参阅

适用于

Font(String, Single, FontStyle)

参数

例外

注解

适用于

Font(FontFamily, Single, GraphicsUnit)

参数

例外

注解

适用于

Font(FontFamily, Single, FontStyle)

参数

例外

示例

注解

适用于

Font(String, Single)

参数

例外

示例

注解

适用于

Font(FontFamily, Single)

参数

例外

注解

适用于

Font(String, Single, GraphicsUnit)

参数

例外

注解

适用于

其他资源