[]
        
(Showing Draft Content)

自定义工作表

GcExcel Java 允许您使用 IWorksheet 接口的方法自定义工作表。您可以执行一些有用的操作,如自定义网格线以修改行和列标题、设置选项卡的颜色、设置行和列的默认高度和宽度等等。

自定义工作表以修改默认设置涉及以下操作:

配置显示

您可以从左到右或从右到左修改工作表的显示设置。

要根据您的首选项配置工作表的显示,请参阅以下示例代码。

// Configure Sheet Settings
Workbook workbook = new Workbook();
        
// Fetch the default worksheet
IWorksheet worksheet = workbook.getWorksheets().get(0);
        
// Assign the values to the cells
worksheet.getRange("B1").setValue("ABCD");
worksheet.getRange("B2").setValue(3);
worksheet.getRange("C1").setValue("GrapeCity Documents");
worksheet.getRange("C2").setValue(4);
worksheet.getRange("D1").setValue("GcExcel");
worksheet.getRange("D2").setValue("ABCD");
worksheet.getSheetView().setDisplayRightToLeft(true);

设置选项卡颜色

可以使用IWorksheet 接口的  setTabColor 方法更改工作表的默认选项卡颜色。


要根据您的首选项设置工作表的选项卡颜色,请参阅以下示例代码。

// Set the tab color of the specified sheet as green.
worksheet.setTabColor(Color.GetGreen());

设置可见性

可以使用IWorksheet 接口的 setVisible 方法显示或隐藏工作表。


要设置工作表的可见性,请参阅以下示例代码。

// Adding new sheet and set the visibility of the sheet as Hidden.
IWorksheet worksheet1 = workbook.getWorksheets().add();
worksheet1.setVisible(Visibility.Hidden);

设置背景图像

可以使用 IWorksheet 接口的 setBackgroundPicture() 方法为工作表设置自定义背景图像。使用此功能,用户可以在工作表中插入任何背景图像,包括组织徽标、自定义水印或自己选择的壁纸。


请参阅以下示例代码,以便在工作表中设置自定义背景图像。

        
// Fetch default worksheet
IWorksheet worksheet = workbook.getWorksheets().get(0);

// To load an image from a specific file in input stream
InputStream inputStream = ClassLoader.getSystemResourceAsStream("GrapeCityLogo.png");
try {
    byte[] bytes = new byte[inputStream.available()];
    // Read an image from input stream
    inputStream.read(bytes, 0, bytes.length);

    // Setting worksheet's BackgroundPicture
    worksheet.setBackgroundPicture(bytes);
} catch (IOException ioe) {
    ioe.printStackTrace();
}
        

定义标准宽度和高度

可以分别使用 IWorksheet 接口的  setStandardHeight 和 setStandardWidth 方法定义工作表的标准高度和宽度。


要根据要求定义标准宽度和高度,请参阅以下代码示例。

// Setting the height and width of the worksheet
worksheet.setStandardHeight(20);
worksheet.setStandardWidth(40);