@HeadFontStyle注解属性介绍

@HeadFontStyle 是一个自定义的 Java 注解，它用于指定 Excel 单元格字体的样式属性。这个注解可以应用于方法中，用来动态地设置 Excel 文件中单元格的字体样式。下面是 @HeadFontStyle 注解中各个属性的详细介绍：

1. fontName (String)

• 类型: String
• 默认值: "" (空字符串)
• 作用: 设置字体的名称。例如，"宋体", "Arial", "Times New Roman" 等。如果不设置，则默认为 Excel 默认字体。
• 示例: "Arial"

2. fontHeightInPoints (short)

• 类型: short
• 默认值: -1
• 作用: 设置字体的大小，单位是“点”（points）。常用的字体大小例如 10、11、12 等。-1 表示未指定字体大小。
• 示例: 11（表示字体大小为 11 点）

3. italic (BooleanEnum)

• 类型: BooleanEnum
• 默认值: BooleanEnum.DEFAULT（默认值）
• 作用: 设置字体是否为斜体。BooleanEnum 是一个枚举类型，可以有以下几种取值：
  • BooleanEnum.DEFAULT: 默认值，表示未明确设置斜体样式。
  • BooleanEnum.TRUE: 设置为斜体。
  • BooleanEnum.FALSE: 设置为非斜体。
• 示例: BooleanEnum.TRUE（表示字体为斜体）

4. strikeout (BooleanEnum)

• 类型: BooleanEnum
• 默认值: BooleanEnum.DEFAULT
• 作用: 设置字体是否带有删除线。BooleanEnum 的取值规则和 italic 相同。
• 示例: BooleanEnum.TRUE（表示字体有删除线）

5. color (short)

• 类型: short
• 默认值: -1
• 作用: 设置字体颜色。通常，颜色通过 IndexedColors 枚举来指定。-1 表示未指定颜色，使用默认字体颜色。
• 示例: IndexedColors.RED.getIndex()（表示字体颜色为红色）

6. typeOffset (short)

• 类型: short
• 默认值: -1
• 作用: 设置字体的“偏移”效果。偏移的含义包括上标（Superscript）和下标（Subscript）。常见的取值包括：
  • Font.SUPERSCRIPT: 上标
  • Font.SUBSCRIPT: 下标
  • -1 表示不使用偏移
• 示例: Font.SUPERSCRIPT（表示字体为上标）

7. underline (byte)

• 类型: byte
• 默认值: -1
• 作用: 设置字体的下划线类型。常见的取值包括：
  • Font.U_NONE: 无下划线
  • Font.U_SINGLE: 单条下划线
  • Font.U_DOUBLE: 双重下划线
  • -1 表示未设置下划线
• 示例: Font.U_SINGLE（表示字体有单条下划线）

8. charset (int)

• 类型: int
• 默认值: -1
• 作用: 设置字体的字符集编码。字符集指定了字体所使用的字符集合。-1 表示使用默认字符集。
• 示例: Charset.forName("UTF-8") （这里是一个示例，实际使用时需要对应的字符集编号）

9. bold (BooleanEnum)

• 类型: BooleanEnum
• 默认值: BooleanEnum.DEFAULT
• 作用: 设置字体是否加粗。BooleanEnum 的取值规则和 italic、strikeout 相同。
  • BooleanEnum.TRUE: 设置为加粗
  • BooleanEnum.FALSE: 设置为非加粗
• 示例: BooleanEnum.TRUE（表示字体加粗）

BooleanEnum 枚举类型（假定定义）

这个枚举类型通常是用来表示布尔值的扩展，可以有如下几种取值：

• BooleanEnum.TRUE: 表示 true。
• BooleanEnum.FALSE: 表示 false。
• BooleanEnum.DEFAULT: 表示默认状态（通常是 null 或不指定值）。

总结

@HeadFontStyle 注解用于配置 Excel 单元格的字体样式，它允许开发者通过方法注解动态地设置字体的多种属性，包括字体名称、大小、颜色、斜体、加粗、删除线、下划线、上标/下标、字符集等。通过这种方式，你可以更加灵活地管理 Excel 单元格的样式。

使用示例

假设你使用 @HeadFontStyle 注解配置字体：

java

@HeadFontStyle(fontName = "Arial", fontHeightInPoints = 12, italic = BooleanEnum.TRUE, bold = BooleanEnum.TRUE, color = IndexedColors.RED.getIndex(),underline = Font.U_SINGLE
)
public void applyFontStyle(Sheet sheet) {// 通过反射等方式应用样式到单元格
}

在实际应用中，可以根据注解的属性来动态生成对应的字体样式，灵活地控制 Excel 文件中的字体展示效果。