range.html
来自「永中OFFICE二次开发帮助文档」· HTML 代码 · 共 1,358 行 · 第 1/5 页
HTML
1,358 行
<BR>
取消组合。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/Range.html#unmerge()">unmerge</A></B>()</CODE>
<BR>
清除选取单元格区域里存在的合并单元格。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/Range.html#unprotect(java.lang.String)">unprotect</A></B>(java.lang.String password)</CODE>
<BR>
解除单元格或单元格区域的保护。</TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>从类 java.lang.Object 继承的方法</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
<P>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>
<A NAME="activate(int, int)"><!-- --></A><H3>
activate</H3>
<PRE>
public void <B>activate</B>(int row,
int column)</PRE>
<DL>
<DD>设置活动单元格。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>row</CODE> - 单元格行号<DD><CODE>column</CODE> - 单元格列号 <p> <b>例子：</b> <pre> //根据指定的行号和列号，将单元格设置为活动单元格。本例将单元格(2, 3)设置为活动单元格。 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook() .getWorksheets().getActiveWorksheet(); Range range = worksheet.getRange("A1:G4"); range.activate(2,3); </pre></DL>
</DD>
</DL>
<HR>
<A NAME="activate(java.lang.String)"><!-- --></A><H3>
activate</H3>
<PRE>
public void <B>activate</B>(java.lang.String cellAddress)</PRE>
<DL>
<DD>设置活动单元格。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>cellAddress</CODE> - 单元格引用，如"A1" <p> <b>例子：</b> <pre> //将单元格"A1"设置为活动单元格。 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook() .getWorksheets().getActiveWorksheet(); Range range = worksheet.getRange("A1:G4"); range.activate("A1"); </pre></DL>
</DD>
</DL>
<HR>
<A NAME="advancedFilter(java.lang.String, java.lang.String, boolean, boolean)"><!-- --></A><H3>
advancedFilter</H3>
<PRE>
public int[] <B>advancedFilter</B>(java.lang.String criteriaRange,
java.lang.String pasteRange,
boolean isCopy,
boolean remove)</PRE>
<DL>
<DD>高级筛选。(基于给定的条件区域从数据清单中筛选或复制数据)
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>criteriaRange</CODE> - 条件区域<DD><CODE>pasteRange</CODE> - 粘贴区域<DD><CODE>isCopy</CODE> - 布尔型，如为true，则把筛选结果拷贝到其他区域；否则，不把筛选结果拷贝到其他区域<DD><CODE>remove</CODE> - 布尔型，如为true，要把重复的内容除去；否则，不把重复的内容除去 <p> <b>例子：</b> <pre> //对单元格区域"B3:E15"进行高级筛选。条件区域为"B4:E18"，粘贴区域为"B21:E22"，不把筛选的结果拷贝到其它区域，不把重复的内容除去。 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook() .getWorksheets().getActiveWorksheet(); Range range = worksheet.getRange("B3:E15"); range.advancedFilter("B4:E18", "B21:E22", false, false); </pre></DL>
</DD>
</DL>
<HR>
<A NAME="allocate(double, double, java.lang.String[], double[])"><!-- --></A><H3>
allocate</H3>
<PRE>
public void <B>allocate</B>(double amount,
double multiple,
java.lang.String[] cellAddress,
double[] fixupValue)</PRE>
<DL>
<DD>将分配总数按照分配比例及条件进行分配。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>amount</CODE> - 分配总额，为double型<DD><CODE>multiple</CODE> - 分配倍数，为double型<DD><CODE>cellAddress</CODE> - 单元格地址引用，为一数组，如无单元格需设置固定值，则为null<DD><CODE>fixupValue</CODE> - double型数组，单元格固定值，必须和单元格地址一一对应。若无单元格需设置固定值，则为null <p> <b>例子：</b> <pre> //将分配总数按照分配比例及条件进行分配。分配总额为5680，分配倍数为10，单元格地址引用为"C7","C8",相应的值为300和500。 Worksheet ws = Application.getWorkbooks().getActiveWorkbook() .getWorksheets().getActiveWorksheet(); Range range = ws.getRange("A1:C1"); range.setValue("红利分配"); range.merge(true); FillAttribute fill = new FillAttribute(); fill.setTexture(Color.cyan); range.setBackground(fill); String[] heading = {"姓名", "年资历", "红利"}; String[] names = {"按时", "但是", "大家", "可和", "的可", "额角", "知道", "小计"}; long[] years = {1, 2, 1, 2, 3, 2, 2}; ws.setCellValue(2, 1, heading, true); ws.setCellValue(3, 1, names, false); ws.setCellValue(3, 2, years, false); ws.setCellValue(3, 3, years, false); range = ws.getRange("A2:C2"); fill.setTexture(Color.yellow); range.setBackground(fill); range = ws.getRange("A3:A10"); FontAttribute font = new FontAttribute(); font.setForeground(Color.blue); range.setFontAttribute(font); Cell cell = ws.getCell("C10"); cell.setValue("=sum(C3:C9)"); range = ws.getRange("C3:C9"); range.allocate(5680, 10, new String[]{"C7", "C8"}, new double[]{350, 500}); </pre></DL>
</DD>
</DL>
<HR>
<A NAME="allowEdit()"><!-- --></A><H3>
allowEdit</H3>
<PRE>
public boolean <B>allowEdit</B>()</PRE>
<DL>
<DD>是否允许编辑。
<P>
<DD><DL>
<DT><B>返回：</B><DD>是否允许编辑，TRUE表示允许编辑，FALSE表示不允许 <p> <b>例子：</b> <pre> //在控制台上输出单元格区域"B3:E5"是否允许编辑，true表示允许编辑，false表示不允许编辑。 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook() .getWorksheets().getActiveWorksheet(); Range range = worksheet.getRange("B3:E5"); boolean allow = range.allowEdit(); System.out.println("allow edit :" + allow); </pre></DL>
</DD>
</DL>
<HR>
<A NAME="analyzeTable(java.lang.String, java.lang.String)"><!-- --></A><H3>
analyzeTable</H3>
<PRE>
public void <B>analyzeTable</B>(java.lang.String rowAddress,
java.lang.String columnAddress)</PRE>
<DL>
<DD>创建一假设分析表。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>rowAddress</CODE> - 若不为null则是引用行的单元格地址<DD><CODE>columnAddress</CODE> - 若不为null则是引用列的单元格地址 <p> <b>例子：</b> <pre> //创建一张假设分析表，引用列的单元格地址"B8"。 Worksheet ws = Application.getWorkbooks().getActiveWorkbook() .getWorksheets().getActiveWorksheet(); ws.setCellValue(1, 1, "银行贷款分析"); Range range = ws.getRange("A1:D2"); range.merge(true); FillAttribute fill = new FillAttribute(); fill.setTexture(Color.yellow); range.setBackground(fill); String[] items = {"迂腐顶金", "贷款额", "贷款期限", "利率"}; ws.setCellValue(5, 1, items, false); ws.setCellValue(5, 2, "无"); ws.setCellValue(6, 2, 500000); ws.setCellValue(7, 2, 48); ws.setCellValue(8, 2, 0.075); double[] rate = {0.07, 0.080, 0.085, 0.09}; ws.setCellValue(4, 3, "假设利率"); ws.setCellValue(5, 3, rate, false); ws.setCellValue(3, 4, "月支付额"); ws.setCellValue(4, 4, "=PMT(B8/12, B7, B6)"); range = ws.getRange("C4:D8"); range.analyzeTable(null, "B8"); </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当给定的区域地址错误或越界</DL>
</DD>
</DL>
<HR>
<A NAME="autoFill(java.lang.String, int)"><!-- --></A><H3>
autoFill</H3>
<PRE>
public void <B>autoFill</B>(java.lang.String destination,
int type)</PRE>
<DL>
<DD>用拖曳方式自动填充。（与用右键拖动填充柄来填充系列的效果一样）
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>destination</CODE> - 要填充的单元格，目标区域必须包括源区域。<DD><CODE>type</CODE> - 填充类型，其常量取值如下: <pre> FillConstants.DRAG_DEFAULT 默认的填充类型(序列填充) FillConstants.DRAG_COPY 复制填充 FillConstants.DRAG_SERIES 序列填充 FillConstants.DRAG_FORMAT 格式填充 FillConstants.DRAG_VALUE 数值填充 FillConstants.DRAG_DAY 天数填充 FillConstants.DRAG_WEEKDAY 工作日填充 FillConstants.DRAG_MONTH 月份填充 FillConstants.DRAG_YEAR 年份填充 FillConstants.DRAG_LINEAR 以等差序列填充 FillConstants.DRAG_GROWTH 以等比序列填充 </pre> <p> <b>例子：</b> <pre> //用拖曳方式自动填充区域"C2:C8"填充类型为序列。 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook() .getWorksheets().getActiveWorksheet(); worksheet.setCellValue(2, 3, 5); Range range = worksheet.getRange("C2"); range.autoFill("C2:C8", FillConstants.DRAG_SERIES); </pre><DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/FillConstants.html" title="application.constants 中的接口"><CODE>FillConstants</CODE></A></DL>
</DD>
</DL>
<HR>
<A NAME="autofit()"><!-- --></A><H3>
autofit</H3>
<PRE>
public void <B>autofit</B>()</PRE>
<DL>
⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?