[]
        
(Showing Draft Content)

获得使用区域

“used range”是指已用单元格的边界矩形,该矩形返回指定工作表上已用范围的IRange对象

GcExcel Java使用户可以通过以下方式使用工作表中已使用的单元格范围:

使用工作表的已用范围

在使用工作表的已用范围时,第一步是使用IWorksheet接口的getUsedRange方法获取已用范围。第二步,您可以使用IRange的方法根据您的喜好进一步自定义使用的范围。

请参考以下示例代码获得已用范围并对其进行自定义。

worksheet.getRange("H6:M7").setValue(1);
worksheet.getRange("J9:J10").merge();

// UsedRange is "H6:M10"
String usedrange = worksheet.getUsedRange().toString();
        
// Customize the used range 
usedRange.getInterior().setColor(Color.GetLightBlue());

与used range有关的特性

在处理与used range相关的特性时,第一步是使用IWorksheet接口的getUsedRange方法获取与used range有关的特性。第二步,可以使用IRange接口的方法自定义与used range有关的特性。


为了获得与used range有关的特性并对其进行自定义,请参考以下示例代码。

IComment commentA1 = worksheet.getRange("A1").addComment("Range A1's comment");
IComment commentA2 = worksheet.getRange("A2").addComment("Range A2's comment");
        
// Comment used range is "A1:D5", contains comment shape plot area
EnumSet usedRangeTypes = EnumSet.of(UsedRangeType.Comment);
String commentsUsedRange = worksheet.getUsedRange(usedRangeTypes).toString();
System.out.println(commentsUsedRange);
        
worksheet.getRange("A1:B2").setValue(new Object[][] { { 1, 2 }, { "aaa", "bbb" } });
worksheet.getRange("A2:C3").getInterior().setColor(Color.GetGreen());
        
// Customize the feature related used range by applying style - used range is A2:C3.
IRange usedRange_style = worksheet.getUsedRange(EnumSet.of(UsedRangeType.Style));
usedRange_style.getInterior().setColor(Color.GetLightBlue());
System.out.println(usedRange_style);

在选定范围内获取已用范围

要使用选定范围中的已用范围,可以使用 IRange 接口的 getUsedRange 方法和 getRange 方法。获取后,可以使用 IRange 接口的方法自定义使用的范围。



注意: 如果所选范围不连续,getUsedRange 方法将返回第一个范围的已用范围。

// Init data.
IRange range = worksheet.getRange("B2:D4");
range.setValue("Unused");

// Select range.
IRange selectedRange = worksheet.getRange("C3:E5");
selectedRange.select();

// Get the used range from selectedRange.
IRange usedRange = selectedRange.getUsedRange();
usedRange.setValue("Used");
usedRange.getInterior().setColor(Color.GetLightBlue());

要查看运行的代码,请参阅 获取使用区域 演示示例。


通过上述两种方法中的任何一种获得单元格的使用范围后,您可以根据自己的喜好自定义使用范围。例如,您可以设置行高和列宽;更改行隐藏和列隐藏设置;执行分组和合并操作等基本任务;根据需要将值、公式和注释插入电子表格中的使用范围。