.NETFramework-Drawing：Font

#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();
    }
}