#region 程序集 System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
// C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5\System.Drawing.dll
#endregion
using System.ComponentModel;
using System.Drawing.Design;
using System.Runtime.InteropServices;
using System.Runtime.Serialization;
namespace System.Drawing
{
//
// 摘要:
// 定義特定的文本格式，包括字體、字號和樣式特性。 此類不能被繼承。
[ComVisible(true)]
[Editor("System.Drawing.Design.FontEditor, System.Drawing.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", typeof(UITypeEditor))]
[TypeConverter(typeof(FontConverter))]
public sealed class Font : MarshalByRefObject, ICloneable, ISerializable, IDisposable
{
//
// 摘要:
// 初始化新 System.Drawing.Font，它使用指定的現有 System.Drawing.Font 和 System.Drawing.FontStyle
// 枚舉。
//
// 參數:
// prototype:
// 從中創建新 System.Drawing.Font 的現有 System.Drawing.Font。
//
// newStyle:
// 應用於新 System.Drawing.Font 的 System.Drawing.FontStyle。 可以用 OR 運算符將 System.Drawing.FontStyle
// 枚舉的多個值組合起來。
public Font(Font prototype, FontStyle newStyle);
//
// 摘要:
// 使用指定的大小初始化新 System.Drawing.Font。
//
// 參數:
// familyName:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily 的字符串表示形式。
//
// emSize:
// 新字體的全身大小（以磅為單位）。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無限大或者不是有效的數字。
public Font(string familyName, float emSize);
//
// 摘要:
// 使用指定的大小初始化新 System.Drawing.Font。
//
// 參數:
// family:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily。
//
// emSize:
// 新字體的全身大小（以磅為單位）。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無窮大，或者不是有效的數字。
public Font(FontFamily family, float emSize);
//
// 摘要:
// 使用指定的大小和單位初始化新的 System.Drawing.Font。 樣式設置為 System.Drawing.FontStyle.Regular。
//
// 參數:
// familyName:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily 的字符串表示形式。
//
// emSize:
// 新字體的全身大小（采用 unit 參數指定的單位）。
//
// unit:
// 新字體的 System.Drawing.GraphicsUnit。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無窮大，或者不是有效的數字。
public Font(string familyName, float emSize, GraphicsUnit unit);
//
// 摘要:
// 使用指定的大小和樣式初始化新 System.Drawing.Font。
//
// 參數:
// familyName:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily 的字符串表示形式。
//
// emSize:
// 新字體的全身大小（以磅為單位）。
//
// style:
// 新字體的 System.Drawing.FontStyle。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無窮大，或者不是有效的數字。
public Font(string familyName, float emSize, FontStyle style);
//
// 摘要:
// 使用指定的大小和單位初始化新的 System.Drawing.Font。 將此樣式設置為 System.Drawing.FontStyle.Regular。
//
// 參數:
// family:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily。
//
// emSize:
// 新字體的全身大小（采用 unit 參數指定的單位）。
//
// unit:
// 新字體的 System.Drawing.GraphicsUnit。
//
// 異常:
// T:System.ArgumentNullException:
// family 為 null。
//
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無窮大，或者不是有效的數字。
public Font(FontFamily family, float emSize, GraphicsUnit unit);
//
// 摘要:
// 使用指定的大小和樣式初始化新 System.Drawing.Font。
//
// 參數:
// family:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily。
//
// emSize:
// 新字體的全身大小（以磅為單位）。
//
// style:
// 新字體的 System.Drawing.FontStyle。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無窮大，或者不是有效的數字。
//
// T:System.ArgumentNullException:
// family 為 null。
public Font(FontFamily family, float emSize, FontStyle style);
//
// 摘要:
// 使用指定的大小、樣式和單位初始化新的 System.Drawing.Font。
//
// 參數:
// familyName:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily 的字符串表示形式。
//
// emSize:
// 新字體的全身大小（采用 unit 參數指定的單位）。
//
// style:
// 新字體的 System.Drawing.FontStyle。
//
// unit:
// 新字體的 System.Drawing.GraphicsUnit。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無限大或者不是有效的數字。
public Font(string familyName, float emSize, FontStyle style, GraphicsUnit unit);
//
// 摘要:
// 使用指定的大小、樣式和單位初始化新的 System.Drawing.Font。
//
// 參數:
// family:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily。
//
// emSize:
// 新字體的全身大小（采用 unit 參數指定的單位）。
//
// style:
// 新字體的 System.Drawing.FontStyle。
//
// unit:
// 新字體的 System.Drawing.GraphicsUnit。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無窮大，或者不是有效的數字。
//
// T:System.ArgumentNullException:
// family 為 null。
public Font(FontFamily family, float emSize, FontStyle style, GraphicsUnit unit);
//
// 摘要:
// 使用指定的大小、樣式、單位和字符集初始化新的 System.Drawing.Font。
//
// 參數:
// familyName:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily 的字符串表示形式。
//
// emSize:
// 新字體的全身大小（采用 unit 參數指定的單位）。
//
// style:
// 新字體的 System.Drawing.FontStyle。
//
// unit:
// 新字體的 System.Drawing.GraphicsUnit。
//
// gdiCharSet:
// 一個 System.Byte，它指定用於此字體的 GDI 字符集。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無窮大，或者不是有效的數字。
public Font(string familyName, float emSize, FontStyle style, GraphicsUnit unit, byte gdiCharSet);
//
// 摘要:
// 使用指定的大小、樣式、單位和字符集初始化新的 System.Drawing.Font。
//
// 參數:
// family:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily。
//
// emSize:
// 新字體的全身大小（采用 unit 參數指定的單位）。
//
// style:
// 新字體的 System.Drawing.FontStyle。
//
// unit:
// 新字體的 System.Drawing.GraphicsUnit。
//
// gdiCharSet:
// 一個 System.Byte，它指定 用於新字體的 GDI 字符集。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無窮大，或者不是有效的數字。
//
// T:System.ArgumentNullException:
// family 為 null。
public Font(FontFamily family, float emSize, FontStyle style, GraphicsUnit unit, byte gdiCharSet);
//
// 摘要:
// 使用指定的大小、樣式、單位和字符集初始化新的 System.Drawing.Font。
//
// 參數:
// family:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily。
//
// emSize:
// 新字體的全身大小（采用 unit 參數指定的單位）。
//
// style:
// 新字體的 System.Drawing.FontStyle。
//
// unit:
// 新字體的 System.Drawing.GraphicsUnit。
//
// gdiCharSet:
// 一個 System.Byte，它指定 用於此字體的 GDI 字符集。
//
// gdiVerticalFont:
// 一個布爾值，該值指示新字體是否從 GDI 垂直字體派生。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無窮大，或者不是有效的數字。
//
// T:System.ArgumentNullException:
// family 為 null
public Font(FontFamily family, float emSize, FontStyle style, GraphicsUnit unit, byte gdiCharSet, bool gdiVerticalFont);
//
// 摘要:
// 使用指定的大小、樣式、單位和字符集初始化新 System.Drawing.Font。
//
// 參數:
// familyName:
// 新 System.Drawing.Font 的 System.Drawing.FontFamily 的字符串表示形式。
//
// emSize:
// 新字體的全身大小（采用 unit 參數指定的單位）。
//
// style:
// 新字體的 System.Drawing.FontStyle。
//
// unit:
// 新字體的 System.Drawing.GraphicsUnit。
//
// gdiCharSet:
// 一個 System.Byte，它指定用於此字體的 GDI 字符集。
//
// gdiVerticalFont:
// 一個布爾值，該值指示新 System.Drawing.Font 是否從 GDI 垂直字體派生。
//
// 異常:
// T:System.ArgumentException:
// emSize 是小於或等於 0，計算結果為無窮大，或者不是有效的數字。
public Font(string familyName, float emSize, FontStyle style, GraphicsUnit unit, byte gdiCharSet, bool gdiVerticalFont);
//
// 摘要:
// 在垃圾回收將某一對象回收前允許該對象嘗試釋放資源並執行其他清理操作。
~Font();
//
// 摘要:
// 獲取一個字節值，該值指定此 System.Drawing.Font 使用的 GDI 字符集。
//
// 返回結果:
// 一個字節值，該值指定此 GDI 使用的 System.Drawing.Font 字符集。 默認值為 1。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public byte GdiCharSet { get; }
//
// 摘要:
// 獲取一個布爾值，該值指示此 System.Drawing.Font 是否從 GDI 垂直字體派生。
//
// 返回結果:
// 如果此 System.Drawing.Font 是從 GDI 垂直字體派生的，則為 true；否則為 false。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public bool GdiVerticalFont { get; }
//
// 摘要:
// 獲取一個值，該值指示此字體是否已應用斜體樣式。
//
// 返回結果:
// true 表明此字體已應用斜體樣式；否則為 false。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public bool Italic { get; }
//
// 摘要:
// 獲取此 System.Drawing.Font 的字體名稱。
//
// 返回結果:
// 此 System.Drawing.Font 的字體名稱的字符串表示形式。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[Editor("System.Drawing.Design.FontNameEditor, System.Drawing.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", typeof(UITypeEditor))]
[TypeConverter(typeof(FontConverter.FontNameConverter))]
public string Name { get; }
//
// 摘要:
// 獲取最初指定的字體的名稱。
//
// 返回結果:
// 表示最初指定的字體的名稱的字符串。
[Browsable(false)]
public string OriginalFontName { get; }
//
// 摘要:
// 獲取一個值，該值指示此 System.Drawing.Font 是否指定貫穿字體的橫線。
//
// 返回結果:
// 如果有一條橫線貫穿此 System.Drawing.Font，則為 true；否則為 false。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public bool Strikeout { get; }
//
// 摘要:
// 獲取此字體的行距。
//
// 返回結果:
// 此字體的行距（以像素為單位）。
[Browsable(false)]
public int Height { get; }
//
// 摘要:
// 獲取此 System.Drawing.Font 的樣式信息。
//
// 返回結果:
// 包含此 System.Drawing.Font 的樣式信息的 System.Drawing.FontStyle 枚舉。
[Browsable(false)]
public FontStyle Style { get; }
//
// 摘要:
// 獲取此 System.Drawing.Font 的全身大小，單位采用 System.Drawing.Font.Unit 屬性指定的單位。
//
// 返回結果:
// 此 System.Drawing.Font 的全身大小。
public float Size { get; }
//
// 摘要:
// 獲取此 System.Drawing.Font 的全身大小（以點為單位）。
//
// 返回結果:
// 此 System.Drawing.Font 的全身大小（以點為單位）。
[Browsable(false)]
public float SizeInPoints { get; }
//
// 摘要:
// 獲取此 System.Drawing.Font 的度量單位。
//
// 返回結果:
// 一個 System.Drawing.GraphicsUnit，它表示此 System.Drawing.Font 的度量單位。
[TypeConverter(typeof(FontConverter.FontUnitConverter))]
public GraphicsUnit Unit { get; }
//
// 摘要:
// 獲取一個值，該值指示此 System.Drawing.Font 是否為粗體。
//
// 返回結果:
// 如果此 System.Drawing.Font 為粗體，則為 true；否則為 false。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public bool Bold { get; }
//
// 摘要:
// 獲取一個值，該值指示此 System.Drawing.Font 是否有下划線。
//
// 返回結果:
// 如果此 System.Drawing.Font 有下划線，則為 true；否則為 false。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public bool Underline { get; }
//
// 摘要:
// 獲取與此 System.Drawing.FontFamily 關聯的 System.Drawing.Font。
//
// 返回結果:
// 與此 System.Drawing.FontFamily 關聯的 System.Drawing.Font。
[Browsable(false)]
public FontFamily FontFamily { get; }
//
// 摘要:
// 如果 System.Drawing.Font.IsSystemFont 屬性返回 true，則獲取系統字體的名稱。
//
// 返回結果:
// 如果 System.Drawing.Font.IsSystemFont 返回 true，則為系統字體的名稱；否則為一個空字符串 ("")。
[Browsable(false)]
public string SystemFontName { get; }
//
// 摘要:
// 獲取一個值，該值表示此字體是否是 System.Drawing.SystemFonts 的一個成員。
//
// 返回結果:
// 如果此字體是 System.Drawing.SystemFonts 的一個成員，則為 true；否則為 false。 默認值為 false。
[Browsable(false)]
public bool IsSystemFont { get; }
//
// 摘要:
// 從設備上下文的指定 Windows 句柄創建 System.Drawing.Font。
//
// 參數:
// hdc:
// 設備上下文的句柄。
//
// 返回結果:
// 此方法創建的 System.Drawing.Font。
//
// 異常:
// T:System.ArgumentException:
// 指定的設備上下文的字體不 TrueType 字體。
public static Font FromHdc(IntPtr hdc);
//
// 摘要:
// 從指定的 Windows 句柄創建一個 System.Drawing.Font。
//
// 參數:
// hfont:
// GDI 字體的 Windows 句柄。
//
// 返回結果:
// 此方法創建的 System.Drawing.Font。
//
// 異常:
// T:System.ArgumentException:
// hfont 指向一個對象，它不 TrueType 字體。
public static Font FromHfont(IntPtr hfont);
//
// 摘要:
// 從指定的 GDI 邏輯字體 (LOGFONT) 結構創建一個 System.Drawing.Font。
//
// 參數:
// lf:
// 一個 System.Object，它表示從中創建 System.Drawing.Font 的 GDI LOGFONT 結構。
//
// hdc:
// 包含有關 lf 結構的其他信息的設備上下文的句柄。
//
// 返回結果:
// 此方法創建的 System.Drawing.Font。
//
// 異常:
// T:System.ArgumentException:
// 不，該字體為 TrueType 字體。
public static Font FromLogFont(object lf, IntPtr hdc);
//
// 摘要:
// 從指定的 GDI 邏輯字體 (LOGFONT) 結構創建一個 System.Drawing.Font。
//
// 參數:
// lf:
// 一個 System.Object，它表示從中創建 System.Drawing.Font 的 GDI LOGFONT 結構。
//
// 返回結果:
// 此方法創建的 System.Drawing.Font。
public static Font FromLogFont(object lf);
//
// 摘要:
// 創建此 System.Drawing.Font 的一個精確副本。
//
// 返回結果:
// 此方法創建的、強制轉換為 System.Object 的 System.Drawing.Font。
public object Clone();
//
// 摘要:
// 釋放此 System.Drawing.Font 使用的所有資源。
public void Dispose();
//
// 摘要:
// 指示指定對象是否為 System.Drawing.Font，以及是否具有與此 System.Drawing.Font 相同的 System.Drawing.Font.FontFamily、System.Drawing.Font.GdiVerticalFont、System.Drawing.Font.GdiCharSet、System.Drawing.Font.Style、System.Drawing.Font.Size
// 和 System.Drawing.Font.Unit 屬性值。
//
// 參數:
// obj:
// 要測試的對象。
//
// 返回結果:
// 如果 obj 參數為 System.Drawing.Font 並且具有與此 System.Drawing.Font 相同的 System.Drawing.Font.FontFamily、System.Drawing.Font.GdiVerticalFont、System.Drawing.Font.GdiCharSet、System.Drawing.Font.Style、System.Drawing.Font.Size
// 和 System.Drawing.Font.Unit 屬性值，則為 true；否則為 false。
public override bool Equals(object obj);
//
// 摘要:
// 獲取此 System.Drawing.Font 的哈希代碼。
//
// 返回結果:
// 此 System.Drawing.Font 的哈希代碼。
public override int GetHashCode();
//
// 摘要:
// 返回此字體的行距（以像素為單位）。
//
// 返回結果:
// 此字體的行距（以像素為單位）。
public float GetHeight();
//
// 摘要:
// 采用指定的 System.Drawing.Graphics 的當前單位，返回此字體的行距。
//
// 參數:
// graphics:
// 一個 System.Drawing.Graphics 對象，它存儲顯示設備的垂直分辨率（每英寸點數）、頁面單位和頁面比例設置。
//
// 返回結果:
// 此字體的行距（以像素為單位）。
//
// 異常:
// T:System.ArgumentNullException:
// graphics 為 null。
public float GetHeight(Graphics graphics);
//
// 摘要:
// 當用指定的垂直分辨率繪制到設備時，返回此 System.Drawing.Font 的高度（以像素為單位）。
//
// 參數:
// dpi:
// 用於計算字體高度的垂直分辨率，以每英寸的點數為單位。
//
// 返回結果:
// 此 System.Drawing.Font 的高度（以像素為單位）。
public float GetHeight(float dpi);
//
// 摘要:
// 返回此 System.Drawing.Font 的句柄。
//
// 返回結果:
// 此 System.Drawing.Font 的 Windows 句柄。
//
// 異常:
// T:System.ComponentModel.Win32Exception:
// 該操作不成功。
public IntPtr ToHfont();
//
// 摘要:
// 從此 System.Drawing.Font 創建一個 GDI 邏輯字體 (LOGFONT) 結構。
//
// 參數:
// logFont:
// 一個 System.Object，它表示此方法創建的 LOGFONT 結構。
//
// graphics:
// 一個 System.Drawing.Graphics，它提供 LOGFONT 結構的其他信息。
//
// 異常:
// T:System.ArgumentNullException:
// graphics 為 null。
public void ToLogFont(object logFont, Graphics graphics);
//
// 摘要:
// 從此 System.Drawing.Font 創建一個 GDI 邏輯字體 (LOGFONT) 結構。
//
// 參數:
// logFont:
// 一個 System.Object，它表示此方法創建的 LOGFONT 結構。
public void ToLogFont(object logFont);
//
// 摘要:
// 返回此 System.Drawing.Font 可讀的字符串表示形式。
//
// 返回結果:
// 表示此 System.Drawing.Font 的字符串。
public override string ToString();
}
}
