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，這個 Font 使用指定的現有 Font 和 FontStyle。

多載

Font(Font, FontStyle)	初始化新的 Font，這個 Font 會使用指定的現有 Font 和 FontStyle 列舉。
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)

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

初始化新的 Font，這個 Font 會使用指定的現有 Font 和 FontStyle 列舉。

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 Form 搭配使用。將下列程式代碼貼到窗體中，並將 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 字型，將會導致改用 sans Serif 字型Microsoft。如果您的應用程式相依於此行為，而且您必須重新編譯 .NET Framework 3.0 的應用程式，您應該為 prototype指定 Microsoft Sans Serif 字型。

適用於

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

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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

新字型的 em 大小，以 unit 參數所指定的單位為單位。

style: FontStyle

新字型的 FontStyle。

unit: GraphicsUnit

新字型的 GraphicsUnit。

gdiCharSet: Byte

Byte，指定要用於此字型的 GDI 字元集。

gdiVerticalFont: Boolean

布爾值，指出新的 Font 是否衍生自 GDI 垂直字型。

例外狀況

ArgumentException

emSize 小於或等於0、評估為無限大或不是有效的數位。

備註

gdiCharSet 參數會從 Windows SDK 頭檔 WinGDI.h 中定義的清單中取得值。如果 familyName 參數指定未安裝在執行應用程式或不支援之電腦上的字型，則會取代 Microsoft Sans Serif。

另請參閱

GdiCharSet

適用於

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

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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

新字型的 em 大小，以 unit 參數所指定的單位為單位。

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)

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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

新字型的 em 大小，以 unit 參數所指定的單位為單位。

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)

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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

新字型的 em 大小，以 unit 參數所指定的單位為單位。

style: FontStyle

新字型的 FontStyle。

unit: GraphicsUnit

新字型的 GraphicsUnit。

例外狀況

ArgumentException

emSize 小於或等於0、評估為無限大或不是有效的數位。

範例

下列程式代碼範例示範如何使用 Font 建構函式。此範例的設計目的是要與 Windows Forms 搭配使用。若要執行此範例，請將此程式代碼貼到包含名為 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 Forms 應用程式支援 TrueType 字型，而且對 OpenType 字型的支援有限。如果 familyName 參數指定未安裝在執行應用程式或不支援之電腦上的字型，則會取代 Microsoft Sans Serif。

適用於

Font(FontFamily, Single, FontStyle, GraphicsUnit)

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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

新字型的 em 大小，以 unit 參數所指定的單位為單位。

style: FontStyle

新字型的 FontStyle。

unit: GraphicsUnit

新字型的 GraphicsUnit。

例外狀況

ArgumentException

emSize 小於或等於0、評估為無限大或不是有效的數位。

ArgumentNullException

family null。

適用於

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

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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

新字型的 em 大小，以 unit 參數所指定的單位為單位。

style: FontStyle

新字型的 FontStyle。

unit: GraphicsUnit

新字型的 GraphicsUnit。

gdiCharSet: Byte

Byte，指定要用於此字型的 GDI 字元集。

例外狀況

ArgumentException

emSize 小於或等於0、評估為無限大或不是有效的數位。

備註

gdiCharSet 參數會從 Windows SDK 頭檔 WinGDI.h 中定義的清單中取得值。 Windows Forms 應用程式支援 TrueType 字型，而且對 OpenType 字型的支援有限。如果 familyName 參數指定未安裝在執行應用程式或不支援之電腦上的字型，則會取代 Microsoft Sans Serif。

另請參閱

GdiCharSet

適用於

Font(String, Single, FontStyle)

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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-size，以點為單位。

style: FontStyle

新字型的 FontStyle。

例外狀況

ArgumentException

emSize 小於或等於0、評估為無限大或不是有效的數位。

備註

產生的字型會將其 Unit 屬性設定為 Point。 Windows Forms 應用程式支援 TrueType 字型，而且對 OpenType 字型的支援有限。如果 familyName 參數指定未安裝在執行應用程式或不支援之電腦上的字型，則會取代 Microsoft Sans Serif。

適用於

Font(FontFamily, Single, GraphicsUnit)

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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

新字型的 em 大小，以 unit 參數所指定的單位為單位。

unit: GraphicsUnit

新字型的 GraphicsUnit。

例外狀況

ArgumentNullException

family null。

ArgumentException

emSize 小於或等於0、評估為無限大或不是有效的數位。

備註

產生的字型會將其 Style 屬性設定為 FontStyle.Regular。

適用於

Font(FontFamily, Single, FontStyle)

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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-size，以點為單位。

style: FontStyle

新字型的 FontStyle。

例外狀況

ArgumentException

emSize 小於或等於0、評估為無限大或不是有效的數位。

ArgumentNullException

family null。

範例

下列程式代碼範例示範如何將按鈕的 Font 屬性設定為新的粗體樣式 Font。此範例的設計目的是要與包含名為 Button1按鈕的 Windows Form 搭配使用。將下列程式代碼貼到窗體中，並將 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)

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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-size，以點為單位。

例外狀況

ArgumentException

emSize 小於或等於0、評估為無限大或不是有效的數位。

範例

下列程式代碼範例示範如何使用 Font 建構函式。此範例的設計目的是要與 Windows Form 搭配使用，而且需要 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 Forms 應用程式支援 TrueType 字型，而且對 OpenType 字型的支援有限。如果 familyName 參數指定未安裝在執行應用程式或不支援之電腦上的字型，則會取代 Microsoft Sans Serif。

適用於

Font(FontFamily, Single)

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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-size，以點為單位。

例外狀況

ArgumentException

emSize 小於或等於0、評估為無限大或不是有效的數位。

備註

產生的字型會將其 Style 屬性設定為 Regular，而其 Unit 屬性設定為 Point。

適用於

Font(String, Single, GraphicsUnit)

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: Font.cs

來源:: 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

新字型的 em 大小，以 unit 參數所指定的單位為單位。

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)

參數

例外狀況

備註

適用於

其他資源