ExcelColumn (Excel Write/Read Framework 0.5.25 API)

```
@Target(value={FIELD,METHOD})
 @Retention(value=RUNTIME)
 @Inherited
 @Documented
 @Repeatable(value=ExcelColumns.class)
public @interface ExcelColumn
```
指定Excel列属性，用于设置Title、列宽等常用属性
基于数据安全考虑，默认只会导出标有@ExcelColumn注解的属性和方法，使用Workbook.forceExport() 可以绕过此限制强制导出所有字段，但并不建议这么做，Bean对象被其它人添加了敏感字段则会在无预警的情况下被导出导致信息泄露，本工具不会对此类安全事故负责。

多个@ExcelColumn注解组合可以实现多行表头，value()相同的行或列会自动合并。默认情况下导出顺序是按照Bean定义顺序，也可以通过colIndex()指定列顺序，对于多行表头必须将该属性定义在最底层的@ExcelColumn注解上。

不建议使用@ExcelColumn注解来导出Excel，开发者推荐手动指定Column 后者不会破坏Java对象，且有更丰富的属性和转换器

参考文档:

WIKI 设置多行表头

WIKI 指定导出时的列顺序和位置

作者:

guanquan.wang at 2019-06-21 09:53

可选元素概要

可选元素
限定符和类型	可选元素和说明
`int`	`colIndex` 设置列索引，取值范围 `0 <= colIndex < 16384` 默认情况下导出的列顺序与字段在对象中的定义顺序或指定的Column数组顺序一致，使用`colIndex`将指定一个绝对位置且仅作用于当前字段，其后的字段并不会基于当前字段的序号自增。
`HeaderComment`	`comment` 设置表头“批注” `HeaderComment`注解可以单独使用，如果此注释与HeaderComment同时出现时，则独立的HeaderComment注释优先注意: 该注解只作用于表头
`Class<? extends Converter<?>>`	`converter` 数据转换，导出的时候可以将不可读的状态码或者枚举值转为可读的文本，导入的时候则做相反的工作。
`String`	`format` 设置单元格格式只支持Office指定的格式，请参阅`NumFmt`.
`boolean`	`hide` 设置列隐藏导出时标记隐藏列的数据会正常写，只是使用Office等工具打开时该列默认不显示，你可以使用鼠标右键选择“取消隐藏” 来查看数据，某些情况下可以起到数据安全的作用。
`double`	`maxWidth` 设置列宽如果当前列设置"自适应列宽"且不是`MEDIA`类型则`width = min(自适应列宽, maxWidth)`，否则`width = maxWidth`。
`boolean`	`share` 设置字符串共享默认使用`inline`模式输出字符串，即将字符串直接写到每个Cell里并不共享。
`String`	`value` 设置列名，如果未指定则默认使用字段或者方法名做为列名
`boolean`	`wrapText` 单元格自动折行 Microsoft Excel可以将文本折行使其显示在单元格中的多行中。

- 元素详细资料
  - value
```
public abstract String value
```
    设置列名，如果未指定则默认使用字段或者方法名做为列名
    
    返回:
    
    列名
    
    默认值:
    
    ""
- - share
```
public abstract boolean share
```
    设置字符串共享
    默认使用inline模式输出字符串，即将字符串直接写到每个Cell里并不共享。对于某些枚举值的列使用字符串共享将会起到压缩目的，比如"姓别"列只会有“男”，“女”和“未知”三种值。
    
    共享字符串会将值写入一个公共区域，xlsx格式保存在sharedStrings.xml文件中，整个Workbook的所有Worksheet共享
    
    返回:
    
    true: 共享，false: 直写（默认）
    
    另请参阅:
    
    SharedStrings
    
    默认值:
    
    false
- - comment
```
public abstract HeaderComment comment
```
    设置表头“批注”
    HeaderComment注解可以单独使用，如果此注释与HeaderComment同时出现时，则独立的HeaderComment注释优先
    
    注意: 该注解只作用于表头
    
    返回:
    
    表头“批注”
    
    默认值:
    
    @org.ttzero.excel.annotation.HeaderComment
- - format
```
public abstract String format
```
    设置单元格格式
    只支持Office指定的格式，请参阅NumFmt. 如果不知道格式是否有效可以先在Office里调试，然后将调试好的字符串复制过来即可，
    
    注意: 此属性只作用于数字或者日期(包含 Timestamp, Time and java.time.*).
```
 @ExcelColumn(format = "yyyy-mm-dd hh:mm:ss") // 日期格式化 2019-06-21 09:53:21
 @ExcelColumn(format = "#,##0.00") // 数字格式化 13,541.00
 
```
    返回:
    
    格式化
    
    默认值:
    
    ""
- - wrapText
```
public abstract boolean wrapText
```
    单元格自动折行
    Microsoft Excel可以将文本折行使其显示在单元格中的多行中。以下两种情况将触发自动折行，一是字符串长度超过列宽，二是字符串包含"回车"符
    
    返回:
    
    true: 自动折行 false: 不换行（默认）
    
    默认值:
    
    false
- - colIndex
```
public abstract int colIndex
```
    设置列索引，取值范围 0 <= colIndex < 16384
    默认情况下导出的列顺序与字段在对象中的定义顺序或指定的Column数组顺序一致，使用colIndex将指定一个绝对位置且仅作用于当前字段，其后的字段并不会基于当前字段的序号自增。如果存在相同的colIndex则按字段在对象中的定义顺序进行重排。任何负数均表示“未设置”，将按照默认顺序处理
    
    返回:
    
    有效范围[0, 16384)，任何小于0的值均表示"未设置"
    
    默认值:
    
    -1
- - maxWidth
```
public abstract double maxWidth
```
    设置列宽
    如果当前列设置"自适应列宽"且不是MEDIA类型则width = min(自适应列宽, maxWidth)，否则width = maxWidth。
    
    任何负数均表示”未设置“，默认列宽为20，可以使用Sheet.fixedSize(double)重置
    
    返回:
    
    有效范围 [0, 256)，任何小于0的值均表示"未设置"
    
    默认值:
    
    -1.0
- - hide
```
public abstract boolean hide
```
    设置列隐藏
    导出时标记隐藏列的数据会正常写，只是使用Office等工具打开时该列默认不显示，你可以使用鼠标右键选择“取消隐藏” 来查看数据，某些情况下可以起到数据安全的作用。
    
    在隐藏列上其设置的所有属性依旧有效，比如设置自适应列宽，那么该列显示时依旧会显示“自适应列宽”
    
    返回:
    
    true: 隐藏，false: 显示（默认）
    
    默认值:
    
    false
- - converter
```
public abstract Class<? extends Converter<?>> converter
```
    数据转换，导出的时候可以将不可读的状态码或者枚举值转为可读的文本，导入的时候则做相反的工作。它不是必须的通常建议在创建列的时候直接使用ConversionProcessor 表达式更简洁无需定义一个类来处理
    
    返回:
    
    数据转换器，默认None无转换
    
    默认值:
    
    org.ttzero.excel.processor.Converter.None.class

注释类型 ExcelColumn

可选元素概要

元素详细资料

value

share

comment

format

wrapText

colIndex

maxWidth

hide

converter