ITable

Interface ITable

public interface ITable

表示工作表上的表对象。

一个 ITable 定义结构化数据区域，可包含标题行、数据行、汇总、筛选、排序和表特定格式。调用 ITables.add(IRange,boolean) 向工作表添加表时会返回 ITable 对象。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Test", 100},
     {"Hello", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setDisplayName("Table1");

Method Summary

Modifier and Type

Method

Description

void

convertToRange()

将此表转换为普通单元格区域。

void

delete()

删除此 ITable 对象，并从工作表中清除单元格数据。

void

fromJson(String json)

从指定的 JSON 字符串生成表。

IAutoFilter

getAutoFilter()

获取此表的 IAutoFilter。

boolean

getAutoGenerateColumns()

获取表绑定到数据源时是否自动生成列。

String

getBindingPath()

获取当前表的绑定路径。

ITableColumns

getColumns()

获取此 ITable 中的列集合。

String

getComment()

获取与表对象关联的注释。

IRange

getDataRange()

获取表示表数据区域的 IRange。

String

getDisplayName()

获取此 ITable 的显示名称。

boolean

getExpandBoundRows()

获取表在数据绑定期间是否可以添加或删除整个工作表行。

IRange

getHeaderRange()

获取表示表标题行的 IRange 对象。

String

getName()

获取表格的名称。

IRange

getRange()

返回表示指定表对象所应用区域的 IRange 对象。

ITableRows

getRows()

获取此 ITable 中数据行的集合。

boolean

getShowAutoFilter()

获取是否显示自动筛选。

boolean

getShowAutoFilterDropDown()

获取表筛选按钮是否可见。

boolean

getShowHeaders()

获取此 ITable 是否显示包含列名的标题行。

boolean

getShowTableStyleColumnStripes()

获取列条纹表样式是否应用于此 ITable。

boolean

getShowTableStyleFirstColumn()

获取表样式是否应用于第一列。

boolean

getShowTableStyleLastColumn()

获取表样式是否应用于最后一列。

boolean

getShowTableStyleRowStripes()

获取是否为此 ITable 显示行条纹。

boolean

getShowTotals()

获取汇总行是否可见。

ISort

getSort()

获取此 ITable 的排序设置。

ITableStyle

getTableStyle()

获取应用于表格的表格样式。

IRange

getTotalsRange()

获取表的汇总行区域。

void

resize(IRange range)

将此 ITable 调整为新的区域，而不插入或移动单元格。

void

setAutoGenerateColumns(boolean value)

设置表在绑定到数据源时是否自动生成列。

void

setBindingPath(String value)

设置当前表的绑定路径。

void

setComment(String value)

设置与表对象关联的注释。

void

setDisplayName(String value)

为指定的 ITable 设置显示名称。

void

setExpandBoundRows(boolean value)

设置该表在数据绑定期间是否可以添加或删除整个工作表行。

void

setName(String value)

设置表格的名称。

void

setShowAutoFilter(boolean value)

设置是否显示自动筛选。

void

setShowAutoFilterDropDown(boolean value)

设置表格筛选按钮是否可见。

void

setShowHeaders(boolean value)

设置此 ITable 是否显示包含列名的标题行。

void

setShowTableStyleColumnStripes(boolean value)

设置是否将列条纹表格样式应用于此 ITable。

void

setShowTableStyleFirstColumn(boolean value)

设置表格样式是否格式化第一列。

void

setShowTableStyleLastColumn(boolean value)

设置是否为此 ITable 显示最后一列样式。

void

setShowTableStyleRowStripes(boolean value)

设置是否对此 ITable 显示行条纹。

void

setShowTotals(boolean value)

设置总计行是否可见。

void

setTableStyle(ITableStyle value)

设置应用于表格的表格样式。

String

toJson()

从表生成 JSON 字符串。

Method Details

getName

String getName()

获取表格的名称。

使用此方法可以检索在工作表中标识该表的表名。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Product", "Amount"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setName("SalesTable");
 String name = table.getName();

Returns:: 表格的名称。

setName

void setName(String value)

设置表格的名称。

使用此方法可设置用于在工作表中标识该表的表名。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Product", "Amount"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setName("SalesTable");
 ITable namedTable = worksheet.getTables().get("SalesTable");
 String namedTableAddress = namedTable.getRange().getAddress();

Parameters:: value - 表格的名称。

getDisplayName

String getDisplayName()

获取此 ITable 的显示名称。

显示名称是面向用户的表名称。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Product", "Amount"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setDisplayName("SalesTable");
 String displayName = table.getDisplayName();

Returns:: 指定 ITable 的显示名称。显示名称是面向用户的表名称。

setDisplayName

void setDisplayName(String value)

为指定的 ITable 设置显示名称。

显示名称是表面向用户的名称。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Product", "Amount"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setDisplayName("SalesTable");

Parameters:: value - 指定的 ITable 的显示名称。

getComment

String getComment()

获取与表对象关联的注释。

此方法返回先前通过 setComment(String) 为当前表分配的文本。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Test", 100},
     {"Total", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setComment("Monthly summary table");
 String comment = table.getComment();

Returns:: 与表对象关联的注释。此方法返回先前通过 setComment(String) 为当前表分配的文本。

setComment

void setComment(String value)

设置与表对象关联的注释。

使用此方法可为当前表分配注释文本。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Test", 100},
     {"Total", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setComment("Monthly summary table");

Parameters:: value - 与表对象关联的注释。

getSort

ISort getSort()
获取此 ITable 的排序设置。
返回的 ISort 对象提供对应用于表数据的排序字段和排序顺序的访问。配置排序字段后，调用 ISort.apply() 对表排序。
```
 worksheet.getRange("A1:B4").setValue(new Object[][] {
     {"Name", "Score"},
     {"Tom", 80},
     {"Nancy", 95},
     {"Jack", 88}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B4"), true);
 ISort sort = table.getSort();
 sort.getSortFields().add(new ValueSortField(worksheet.getRange("B2:B4"), SortOrder.Descending));
 sort.apply();
 
```
Returns:

此 ITable 的排序设置。返回的 ISort 对象提供对应用于表数据的排序字段和排序顺序的访问。配置排序字段后，调用 ISort.apply() 对表排序。

getAutoFilter

IAutoFilter getAutoFilter()

获取此表的 IAutoFilter。

返回的自动筛选表示应用于表区域的筛选设置。


 worksheet.getRange("A1:C4").setValue(new Object[][] {
     {"Name", "Value", "Category"},
     {"A", 100, "X"},
     {"B", 200, "Y"},
     {"C", 100, "X"}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:C4"), true);
 table.getRange().autoFilter(2, "X");
 IAutoFilter autoFilter = table.getAutoFilter();
 Object criteria1 = autoFilter.getFilters().get(2).getCriteria1();

Returns:: 此表的 IAutoFilter。返回的 IAutoFilter 表示应用于表区域的筛选设置。

getRange

IRange getRange()

返回表示指定表对象所应用区域的 IRange 对象。


 worksheet.getRange("A1:B3").setValue(new Object[][] {{"Name", "Value"}, {"A", 100}, {"B", 200}});
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 IRange tableRange = table.getRange();

Returns:: 表示指定表对象所应用区域的 IRange 对象。

getDataRange

IRange getDataRange()

获取表示表数据区域的 IRange。

返回的区域包含标题行和插入行之间的表行。它不包括标题行。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Apple", 100},
     {"Pear", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 IRange dataRange = table.getDataRange();

Returns:: 表示表数据区域的 IRange 对象。

getHeaderRange

IRange getHeaderRange()

获取表示表标题行的 IRange 对象。

使用此方法可以访问包含表列标题的单元格。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Product", "Amount"},
     {"Apple", 100},
     {"Pear", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 IRange headerRange = table.getHeaderRange();
 headerRange.get(0, 1).setValue("Total");

Returns:: 表示表标题行的 IRange 对象。使用此方法可以访问包含表列标题的单元格。

getTotalsRange

IRange getTotalsRange()

获取表的汇总行区域。

当汇总行可见时，返回 IRange，表示此 ITable 的汇总行。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Product", "Amount"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowTotals(true);
 IRange totalsRange = table.getTotalsRange();

Returns:: 表的汇总行区域。当汇总行可见时，返回表示此 ITable 的汇总行的 IRange。

getShowAutoFilter

boolean getShowAutoFilter()

获取是否显示自动筛选。

仅当显示表标题且表已启用自动筛选时，此方法才返回 true。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Test", 100},
     {"Hello", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowAutoFilter(true);
 boolean showAutoFilter = table.getShowAutoFilter();

Returns:: 如果显示自动筛选，则返回 true；否则返回 false。

setShowAutoFilter

void setShowAutoFilter(boolean value)

设置是否显示自动筛选。

仅当显示表头且为表启用了自动筛选时，此方法才会设置 true。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Test", 100},
     {"Hello", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowAutoFilter(true);

Parameters:: value - 是否显示自动筛选。

getShowAutoFilterDropDown

boolean getShowAutoFilterDropDown()

获取表筛选按钮是否可见。

此属性指示是否在表标题行中显示下拉按钮。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Test", 100},
     {"Hello", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 boolean showAutoFilterDropDown = table.getShowAutoFilterDropDown();

Returns:: 如果显示自动筛选下拉按钮，则返回 true；否则返回 false。

setShowAutoFilterDropDown

void setShowAutoFilterDropDown(boolean value)

设置表格筛选按钮是否可见。

此属性指示表头行中是否显示下拉按钮。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Test", 100},
     {"Hello", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowAutoFilterDropDown(true);

Parameters:: value - 表格筛选按钮是否可见。

getShowHeaders

boolean getShowHeaders()

获取此 ITable 是否显示包含列名的标题行。

使用此属性可查看表是否显示包含列名的标题行。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 boolean showHeaders = table.getShowHeaders();

Returns:: 如果此 ITable 显示包含列名的标题行，则为 true；否则为 false。

setShowHeaders

void setShowHeaders(boolean value)

设置此 ITable 是否显示包含列名的标题行。

使用此属性可设置表是否显示包含列名的标题行。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowHeaders(true);

Parameters:: value - 是否显示此 ITable 中包含列名的标题行。

getShowTableStyleColumnStripes

boolean getShowTableStyleColumnStripes()

获取列条纹表样式是否应用于此 ITable。

当此属性为 true 时，应用的表样式会对表列使用交替格式。


 worksheet.getRange("A1:C3").setValue(new Object[][] {
     {"Name", "Q1", "Q2"},
     {"Tea", 100, 120},
     {"Coffee", 90, 110}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:C3"), true);
 table.setShowTableStyleColumnStripes(true);
 boolean showColumnStripes = table.getShowTableStyleColumnStripes();

Returns:: 如果此 ITable 显示列条纹，则返回 true；否则返回 false。

setShowTableStyleColumnStripes

void setShowTableStyleColumnStripes(boolean value)
设置是否将列条纹表格样式应用于此 ITable。
当此属性为 true 时，应用的表格样式会对表格列使用交替格式。
```
 worksheet.getRange("A1:C3").setValue(new Object[][] {
     {"Name", "Q1", "Q2"},
     {"Tea", 100, 120},
     {"Coffee", 90, 110}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:C3"), true);
 table.setShowTableStyleColumnStripes(true);
 
```
Parameters:

value - 是否将列条纹表格样式应用于此 ITable。

getShowTableStyleFirstColumn

boolean getShowTableStyleFirstColumn()

获取表样式是否应用于第一列。

此属性指示表样式是否应用于当前 ITable 的第一列。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Amount"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowTableStyleFirstColumn(true);
 boolean showFirstColumn = table.getShowTableStyleFirstColumn();

Returns:: 如果表样式应用于第一列，则为 true；否则为 false。

setShowTableStyleFirstColumn

void setShowTableStyleFirstColumn(boolean value)
设置表格样式是否格式化第一列。
此属性指示是否将第一列表格样式元素应用于当前 ITable 的第一列。
```
 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Amount"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowTableStyleFirstColumn(true);
 
```
Parameters:

value - 表格样式是否格式化第一列。

getShowTableStyleLastColumn

boolean getShowTableStyleLastColumn()

获取表样式是否应用于最后一列。

此属性指示表样式是否应用于当前 ITable 的最后一列。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Amount"},
     {"Apple", 100},
     {"Pear", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowTableStyleLastColumn(true);
 boolean showTableStyleLastColumn = table.getShowTableStyleLastColumn();

Returns:: 如果表样式应用于最后一列，则为 true；否则为 false。

setShowTableStyleLastColumn

void setShowTableStyleLastColumn(boolean value)
设置是否为此 ITable 显示最后一列样式。
当此属性为 true 时，应用的表格样式可以突出显示表格的最后一列。
```
 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Amount"},
     {"Apple", 100},
     {"Pear", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowTableStyleLastColumn(true);
 
```
Parameters:

value - 此 ITable 是否显示最后一列样式。

getShowTableStyleRowStripes

boolean getShowTableStyleRowStripes()

获取是否为此 ITable 显示行条纹。

当此属性为 true 时，应用的表样式使用交替行格式。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Tea", 10},
     {"Coffee", 12}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 boolean showRowStripes = table.getShowTableStyleRowStripes();

Returns:: 如果此 ITable 显示行条纹，则返回 true；否则返回 false。

setShowTableStyleRowStripes

void setShowTableStyleRowStripes(boolean value)

设置是否对此 ITable 显示行条纹。

当此属性为 true 时，应用的表样式将使用交替行格式。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Tea", 10},
     {"Coffee", 12}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowTableStyleRowStripes(true);

Parameters:: value - 是否对此 ITable 显示行条纹。

getShowTotals

boolean getShowTotals()

获取汇总行是否可见。

使用此方法可以确定表当前是否显示汇总行。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Product", "Amount"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowTotals(true);
 boolean showTotals = table.getShowTotals();

Returns:: 如果显示汇总行，则返回 true；否则返回 false。

setShowTotals

void setShowTotals(boolean value)

设置总计行是否可见。

使用此方法可设置表是否显示总计行。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Product", "Amount"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setShowTotals(true);

Parameters:: value - 总计行是否可见。

getColumns

ITableColumns getColumns()

获取此 ITable 中的列集合。

返回的 ITableColumns 集合包含属于该表的所有列，包括其名称和数据区域。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Sales"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 ITableColumns columns = table.getColumns();
 ITableColumn salesColumn = columns.get(1);

Returns:: 此 ITable 中的 ITableColumns 列集合。该集合包含属于此表的所有列，包括其名称和数据区域。

getRows

ITableRows getRows()

获取此 ITable 中数据行的集合。

返回的 ITableRows 对象包含属于表数据区域的 ITableRow 对象。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Apple", 100},
     {"Pear", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 ITableRows rows = table.getRows();
 ITableRow firstRow = rows.get(0);

Returns:: 此 ITable 中的 ITableRows 数据行集合。返回的 ITableRows 对象包含属于表数据区域的 ITableRow 对象。

getTableStyle

ITableStyle getTableStyle()

获取应用于表格的表格样式。

返回的 ITableStyle 表示当前应用于该表格的样式，包括内置表格样式和自定义表格样式。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setTableStyle(workbook.getTableStyles().get("TableStyleLight11"));
 ITableStyle tableStyle = table.getTableStyle();

Returns:: 应用于表格的表格样式。

setTableStyle

void setTableStyle(ITableStyle value)

设置应用于表格的表格样式。

使用此方法可将内置表格样式或自定义表格样式应用于该表格。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Apple", 100},
     {"Orange", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setTableStyle(workbook.getTableStyles().get("TableStyleLight11"));

Parameters:: value - 应用于表格的表格样式。

resize

void resize(IRange range)
将此 ITable 调整为新的区域，而不插入或移动单元格。
新区域必须保留在与当前表相同的标题行上，并且必须与当前表区域重叠。此方法不会重新排列工作表单元格；它只更新表边界。
```
 worksheet.getRange("A1:C4").setValue(new Object[][] {
     {"Name", "Region", "Sales"},
     {"Alice", "East", 100},
     {"Bob", "West", 120},
     {"Carol", "North", 140}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:C4"), true);
 worksheet.getRange("D1:D4").setValue(new Object[][] {
     {"Status"},
     {"Open"},
     {"Closed"},
     {"Open"}
 });
 table.resize(worksheet.getRange("A1:D4"));
 
```
Parameters:

range - 新的表区域。必须是单个非空的 IRange，且与当前表区域重叠。

Throws:

IllegalArgumentException - 如果 range 为 null、为空、包含多个选择、不与当前表区域重叠，或未从与当前表相同的行开始。

UnsupportedOperationException - 如果表绑定到数据管理器。

delete

void delete()

删除此 ITable 对象，并从工作表中清除单元格数据。

使用此方法可以同时移除表定义和表覆盖的单元格。若要保留数据并仅移除表对象，请改用 convertToRange()。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Test", 100},
     {"Sample", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.delete();

getBindingPath

String getBindingPath()

获取当前表的绑定路径。

绑定路径标识表绑定到数据源时使用的数据路径。


 worksheet.setDataSource(new JsonDataSource(
     "{\"sales\":[{\"name\":\"Alice\",\"amount\":100},{\"name\":\"Bob\",\"amount\":200}]}"));
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.getColumns().get(0).setDataField("name");
 table.getColumns().get(1).setDataField("amount");
 table.setBindingPath("sales");
 String bindingPath = table.getBindingPath();

Returns:: 当前表的绑定路径。绑定路径标识表绑定到数据源时使用的数据路径。

setBindingPath

void setBindingPath(String value)

设置当前表的绑定路径。

当表绑定到数据源时，绑定路径用于标识所使用的数据路径。


 worksheet.setDataSource(new JsonDataSource(
     "{\"sales\":[{\"name\":\"Alice\",\"amount\":100},{\"name\":\"Bob\",\"amount\":200}]}"));
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.getColumns().get(0).setDataField("name");
 table.getColumns().get(1).setDataField("amount");
 table.setBindingPath("sales");
 Object firstName = worksheet.getRange("A2").getValue();

Parameters:: value - 当前表的绑定路径。

getAutoGenerateColumns

boolean getAutoGenerateColumns()

获取表绑定到数据源时是否自动生成列。

当此属性为 true 时，表可以在数据绑定期间根据绑定数据源中的字段创建列。


 worksheet.setDataSource(new JsonDataSource("{\"ds\":[{\"name\":\"jack\",\"age\":12}]}"));
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:C2"), true);
 table.setAutoGenerateColumns(true);
 table.setBindingPath("ds");
 boolean autoGenerateColumns = table.getAutoGenerateColumns();

Returns:: 如果 Auto Generate Columns 为真，则为 true；否则为 false。

setAutoGenerateColumns

void setAutoGenerateColumns(boolean value)
设置表在绑定到数据源时是否自动生成列。
当此属性为 true 时，表可以在数据绑定期间根据已绑定数据源中的字段创建列。
```
 worksheet.setDataSource(new JsonDataSource("{\"ds\":[{\"name\":\"jack\",\"age\":12}]}"));
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:C2"), true);
 table.setAutoGenerateColumns(true);
 table.setBindingPath("ds");
 
```
Parameters:

value - 表在绑定到数据源时是否自动生成列。

fromJson

void fromJson(String json)

从指定的 JSON 字符串生成表。


 worksheet.getRange("A1:B3").setValue(new Object[][] {{"Name", "Value"}, {"A", 100}, {"B", 200}});
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 String json = table.toJson();
 table.fromJson(json);

Parameters:: json - 用于生成表的 JSON 字符串。

toJson

String toJson()

从表生成 JSON 字符串。


 worksheet.getRange("A1:B3").setValue(new Object[][] {{"Name", "Value"}, {"A", 100}, {"B", 200}});
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 String json = table.toJson();

Returns:: 从表生成的 JSON 字符串。

getExpandBoundRows

boolean getExpandBoundRows()

获取表在数据绑定期间是否可以添加或删除整个工作表行。

此属性指示当绑定数据发生变化时，是否允许表按整行扩展或收缩。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Item A", 100},
     {"Item B", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setExpandBoundRows(true);
 boolean expandBoundRows = table.getExpandBoundRows();

Returns:: 如果 Expand Bound Rows 为真，则为 true；否则为 false。

setExpandBoundRows

void setExpandBoundRows(boolean value)
设置该表在数据绑定期间是否可以添加或删除整个工作表行。
此属性指示当其绑定的数据发生更改时，是否允许该表按整行扩展或收缩。
```
 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Item A", 100},
     {"Item B", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.setExpandBoundRows(true);
 
```
Parameters:

value - 该表在数据绑定期间是否可以添加或删除整个工作表行。

convertToRange

void convertToRange()

将此表转换为普通单元格区域。

调用此方法后，单元格会作为普通区域数据保留在工作表上，而不是作为 ITable 管理。


 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Test", 100},
     {"Hello", 200}
 });
 ITable table = worksheet.getTables().add(worksheet.getRange("A1:B3"), true);
 table.convertToRange();