org.dromara.hutool.poi.excel.cell

Class CellRangeUtil

java.lang.Object

org.dromara.hutool.poi.excel.cell.CellRangeUtil

public class CellRangeUtil
extends Object

CellRangeAddress 工具类
CellRangeAddress 表示表格的一个区域，通过定义起始行和列，以及结束行和列，圈定范围，如设置合并单元格等。

Since:

6.0.0

Author:

Looly

Constructor Summary

Constructors

Constructor and Description
CellRangeUtil()

Method Summary

Modifier and Type	Method and Description
static org.apache.poi.ss.util.CellRangeAddress	getCellRangeAddress(org.apache.poi.ss.usermodel.Cell cell) 获取合并单元格CellRangeAddress，如果不是返回null
static org.apache.poi.ss.util.CellRangeAddress	getCellRangeAddress(org.apache.poi.ss.usermodel.Sheet sheet, int x, int y) 获取合并单元格CellRangeAddress，如果不是返回null
static org.apache.poi.ss.util.CellRangeAddress	getCellRangeAddress(org.apache.poi.ss.usermodel.Sheet sheet, String locationRef) 获取合并单元格CellRangeAddress，如果不是返回null
static org.apache.poi.ss.util.CellRangeAddress	of(int firstRow, int lastRow, int firstCol, int lastCol) 根据给定的行和列索引创建一个CellRangeAddress对象。
static org.apache.poi.ss.util.CellRangeAddress	of(String ref) 根据字符串表示法创建一个CellRangeAddress对象。
static org.apache.poi.ss.util.CellRangeAddress	ofSingleColumn(int lastRow, int col) 根据给定的行和列索引创建一个单列CellRangeAddress对象，从首行开始。
static org.apache.poi.ss.util.CellRangeAddress	ofSingleColumn(int firstRow, int lastRow, int col) 根据给定的行和列索引创建一个单列CellRangeAddress对象。
static org.apache.poi.ss.util.CellRangeAddress	ofSingleRow(int row, int lastCol) 根据给定的行和列索引创建一个单行的CellRangeAddress对象，从首列开始。
static org.apache.poi.ss.util.CellRangeAddress	ofSingleRow(int row, int firstCol, int lastCol) 根据给定的行和列索引创建一个单行的CellRangeAddress对象。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CellRangeUtil

public CellRangeUtil()

Method Detail

of

public static org.apache.poi.ss.util.CellRangeAddress of(String ref)

根据字符串表示法创建一个CellRangeAddress对象。

该方法提供了一种通过直接使用字符串引用来创建CellRangeAddress对象的便捷方式。 字符串引用应符合Excel中单元格范围的常规表示法，如"B1" 或 "A1:B2"。

Parameters:

ref - 代表单元格范围的字符串，格式为"A1:B2"。

Returns:

根据给定字符串创建的CellRangeAddress对象。

See Also:

CellRangeAddress.valueOf(String)

of

public static org.apache.poi.ss.util.CellRangeAddress of(int firstRow,
                                                         int lastRow,
                                                         int firstCol,
                                                         int lastCol)

根据给定的行和列索引创建一个CellRangeAddress对象。 这个方法提供了一种简洁的方式，来表示一个Excel表格中特定的区域，由起始行和列以及结束行和列定义。

Parameters:

firstRow - 起始行的索引，从0开始计数。

lastRow - 结束行的索引，从0开始计数，必须大于firstRow。

firstCol - 起始列的索引，从0开始计数。

lastCol - 结束列的索引，从0开始计数，必须大于firstCol。

Returns:

返回一个新的CellRangeAddress对象，表示由参数定义的区域。

ofSingleRow

public static org.apache.poi.ss.util.CellRangeAddress ofSingleRow(int row,
                                                                  int lastCol)

根据给定的行和列索引创建一个单行的CellRangeAddress对象，从首列开始。 这个方法提供了一种简洁的方式，来表示一个Excel表格中特定的区域，由起始行和列以及结束行和列定义。

Parameters:

row - 行的索引，从0开始计数。

lastCol - 结束列的索引，从0开始计数，必须大于firstCol。

Returns:

返回一个新的CellRangeAddress对象，表示由参数定义的区域。

ofSingleRow

public static org.apache.poi.ss.util.CellRangeAddress ofSingleRow(int row,
                                                                  int firstCol,
                                                                  int lastCol)

根据给定的行和列索引创建一个单行的CellRangeAddress对象。 这个方法提供了一种简洁的方式，来表示一个Excel表格中特定的区域，由起始行和列以及结束行和列定义。

Parameters:

row - 行的索引，从0开始计数。

firstCol - 起始列的索引，从0开始计数。

lastCol - 结束列的索引，从0开始计数，必须大于firstCol。

Returns:

返回一个新的CellRangeAddress对象，表示由参数定义的区域。

ofSingleColumn

public static org.apache.poi.ss.util.CellRangeAddress ofSingleColumn(int lastRow,
                                                                     int col)

根据给定的行和列索引创建一个单列CellRangeAddress对象，从首行开始。 这个方法提供了一种简洁的方式，来表示一个Excel表格中特定的区域，由起始行和列以及结束行和列定义。

Parameters:

lastRow - 结束行的索引，从0开始计数，必须大于firstRow。

col - 列的索引，从0开始计数。

Returns:

返回一个新的CellRangeAddress对象，表示由参数定义的区域。

ofSingleColumn

public static org.apache.poi.ss.util.CellRangeAddress ofSingleColumn(int firstRow,
                                                                     int lastRow,
                                                                     int col)

根据给定的行和列索引创建一个单列CellRangeAddress对象。 这个方法提供了一种简洁的方式，来表示一个Excel表格中特定的区域，由起始行和列以及结束行和列定义。

Parameters:

firstRow - 起始行的索引，从0开始计数。

lastRow - 结束行的索引，从0开始计数，必须大于firstRow。

col - 列的索引，从0开始计数。

Returns:

返回一个新的CellRangeAddress对象，表示由参数定义的区域。

getCellRangeAddress

public static org.apache.poi.ss.util.CellRangeAddress getCellRangeAddress(org.apache.poi.ss.usermodel.Sheet sheet,
                                                                          String locationRef)

获取合并单元格CellRangeAddress，如果不是返回null

Parameters:

sheet - Sheet

locationRef - 单元格地址标识符，例如A11，B5

Returns:

CellRangeAddress

Since:

5.8.0

getCellRangeAddress

public static org.apache.poi.ss.util.CellRangeAddress getCellRangeAddress(org.apache.poi.ss.usermodel.Cell cell)

获取合并单元格CellRangeAddress，如果不是返回null

Parameters:

cell - Cell

Returns:

CellRangeAddress

Since:

5.8.0

getCellRangeAddress

public static org.apache.poi.ss.util.CellRangeAddress getCellRangeAddress(org.apache.poi.ss.usermodel.Sheet sheet,
                                                                          int x,
                                                                          int y)

获取合并单元格CellRangeAddress，如果不是返回null

Parameters:

sheet - Sheet

x - 列号，从0开始

y - 行号，从0开始

Returns:

CellRangeAddress

Since:

5.8.0