com.zhuozhengsoft.pageoffice.excelwriter
类 Cell

java.lang.Object
  com.zhuozhengsoft.pageoffice.excelwriter.Cell

public class Cell
extends java.lang.Object

Cell 类，代表Excel中定义的单元格对象，用来填充单元格数据及控制单元格格式。

您只能通过调用 Sheet.openCell(String) 方法或 Sheet.openCellRC(int, int) 方法获取 Cell 对象。

版本：

2.0

作者：

北京卓正志远软件有限公司

方法摘要

Border	getBorder() 获取边框对象。
Font	getFont() 获取字体对象。
void	setBackColor(java.awt.Color value) 设置单元格的背景色。
void	setForeColor(java.awt.Color value) 设置单元格的前景色。
void	setFormula(java.lang.String value) 设置单元格的公式。
void	setHorizontalAlignment(XlHAlign value) 设置单元格的水平对齐方式。
void	setNumberFormatLocal(java.lang.String value) 设置单元格的数据显示格式。
void	setReadOnly(boolean value) 设置单元格是否只读。
void	setSubmitName(java.lang.String value) 设置 Cell 的 SubmitName。
void	setValue(java.lang.String value) 设置单元格的值。
void	setVerticalAlignment(XlVAlign value) 设置单元格的垂直对齐方式。

从类 java.lang.Object 继承的方法

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

方法详细信息

setValue

public void setValue(java.lang.String value)
              throws java.io.IOException

设置单元格的值。

抛出：

java.io.IOException

另请参见：

Sheet.openCell()方法中的示例代码。

setFormula

public void setFormula(java.lang.String value)
                throws java.io.IOException

设置单元格的公式。这里的公式完全遵循Excel中定义的公式语法及工作表、单元格引用方式。

抛出：

java.io.IOException

另请参见：

Sheet.openCell()方法中的示例代码。

getBorder

public Border getBorder()
                 throws java.io.IOException

获取边框对象。

抛出：

java.io.IOException

另请参见：

Sheet.openTable()方法中的第二个示例。

setBackColor

public void setBackColor(java.awt.Color value)
                  throws java.io.IOException

设置单元格的背景色。

抛出：

java.io.IOException

另请参见：

Sheet.openCell()方法中的示例代码。

setForeColor

public void setForeColor(java.awt.Color value)
                  throws java.io.IOException

设置单元格的前景色。

抛出：

java.io.IOException

另请参见：

Sheet.openCell()方法中的示例代码。

setReadOnly

public void setReadOnly(boolean value)
                 throws java.io.IOException

设置单元格是否只读。

如果值为true，处于可编辑的Cell将变成只读。如果值为false，处于只读的Cell将变成可编辑。

只有当文档打开模式是 OpenModeType.xlsSubmitForm 时，ReadOnly 属性才有效。默认值为 false。

抛出：

java.io.IOException

setSubmitName

public void setSubmitName(java.lang.String value)
                   throws java.lang.Exception,
                          java.io.IOException

设置 Cell 的 SubmitName。

SubmitName 用来标记当前 Cell 对象在控件保存时需要被提交到 SaveDataPage 服务器页面。只有当您需要提交当前 Cell 中的数据时，才需要定义 SubmitName。 如果您定义了SubmitName，当保存文档时，此 SubmitName 将被作为 com.zhuozhengsoft.pageoffice.excelreader.Sheet.openCell(string) 方法的参数来获取指定的 Cell 对象。 如果您使用的文档打开模式是OpenModeType.xlsSubmitForm，并且当前Cell对象定义了SubmitName，那么此单元格会自动处于可编辑状态。如果此时您需要将单元格设为只读，只要给当前Cell的 ReadOnly 属性赋值true就可以了。

下面的示例展示了如何定义需要提交的Cell。

 Workbook wb = new Workbook();
 Sheet sheet1 = wb.openSheet("sheet1");
 sheet1.openCell("C1").setValue("卓正软件"); // 此单元格不会提交
 
 sheet1.openCell("C2").setValue(""); // 初始化单元格的值
 sheet1.openCell("C2").setSubmitName("CompanyName"); // 此单元格需要提交
 
 sheet1.openCell("D2").setSubmitName("ProductName"); // 此单元格需要提交
 sheet1.openCellRC(2, 5).setSubmitName("ProductCode"); // 此单元格需要提交
 
 poCtrl1.setServerPage("poserver.do"); //此行必须
 poCtrl1.setSaveDataPage("savedata.jsp");
 poCtrl1.setWriter(wb);
 poCtrl1.webOpen("doc/test.xls", OpenModeType.xlsSubmitForm, "张三");
 poCtrl1.setTagId("PageOfficeCtrl1"); //此行必须
 

参数：

value - 由开发者自由定义，一般命名为数据库里数据字段的名字，代码易于理解。这里定义的SubmitName在文档保存时将被用作 com.zhuozhengsoft.pageoffice.excelreader.Sheet.openCell(string) 方法的参数。

SubmitName 在同一个Sheet里应该保持唯一。SubmitName 对大小写敏感。

抛出：

java.lang.Exception

java.io.IOException

getFont

public Font getFont()

获取字体对象。

setHorizontalAlignment

public void setHorizontalAlignment(XlHAlign value)
                            throws java.io.IOException

设置单元格的水平对齐方式。

抛出：

java.io.IOException

setVerticalAlignment

public void setVerticalAlignment(XlVAlign value)
                          throws java.io.IOException

设置单元格的垂直对齐方式。

抛出：

java.io.IOException

setNumberFormatLocal

public void setNumberFormatLocal(java.lang.String value)
                          throws java.io.IOException

设置单元格的数据显示格式。

抛出：

java.io.IOException