protectproperties.html

永中OFFICE二次开发帮助文档

 <p>
 <b>例子: </b>
 <pre>
 //保护当前工作表,密码为"aa",并允许单元格格式和插入列
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = new ProtectProperties();
 protectProperties.setAllowFormattingCells(true);
 protectProperties.setAllowInsertingColumns(true);
 boolean flag = worksheet.protect("aa", protectProperties);
 System.out.println(flag);
 </pre>
<P>
</DL>

<!-- ============ 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="getSelectionStyle()"><!-- --></A><H3>
getSelectionStyle</H3>
<PRE>
public int <B>getSelectionStyle</B>()</PRE>
<DL>
<DD>得到工作表的选取方式。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回工作表选取方式，其取值为如下常量：
 <pre>
 ProtectConstants.NO_SELECTION     -1（没有选取）
 ProtectConstants.NO_RESTRICTIONS 0（对选取无限制）
 ProtectConstants.UNLOCKED_CELLS  1（只选取了未锁定单元格）
 </pre>
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中工作表的选取方式
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 int selection = protectProperties.getSelectionStyle();
 System.out.println(selection);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowDeleteColumns()"><!-- --></A><H3>
isAllowDeleteColumns</H3>
<PRE>
public boolean <B>isAllowDeleteColumns</B>()</PRE>
<DL>
<DD>是否允许删除列。如果为 True，则允许用户在受保护的工作表上删除列，要删除的列中的每个单元格都是解除锁定的。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许删除列
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许删除列
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowDeleteColumns();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowDeleteRows()"><!-- --></A><H3>
isAllowDeleteRows</H3>
<PRE>
public boolean <B>isAllowDeleteRows</B>()</PRE>
<DL>
<DD>是否允许删除行。如果为 True，则允许用户在受保护的工作表上删除行，要删除的行中的每个单元格都是解除锁定的。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许删除行
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许删除行
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowDeleteRows();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowEditingObject()"><!-- --></A><H3>
isAllowEditingObject</H3>
<PRE>
public boolean <B>isAllowEditingObject</B>()</PRE>
<DL>
<DD>是否允许编辑对象。如果为 True，则允许用户在受保护的工作表上使用编辑对象。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许编辑对象
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许编辑对象
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowEditingObject();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowEditingScenarios()"><!-- --></A><H3>
isAllowEditingScenarios</H3>
<PRE>
public boolean <B>isAllowEditingScenarios</B>()</PRE>
<DL>
<DD>是否允许编辑方案。如果为 True，则保护方案。本参数仅对工作表有效。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许编辑方案
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许编辑方案
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowEditingScenarios();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowFiltering()"><!-- --></A><H3>
isAllowFiltering</H3>
<PRE>
public boolean <B>isAllowFiltering</B>()</PRE>
<DL>
<DD>是否允许自动筛选。如果为 True，则允许用户在受保护的工作表上设置筛选。用户可以更改筛选条件，但是不能启用或禁用自动筛选功能。
 用户也可以在已有的自动筛选功能上设置筛选。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许自动筛选
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许自动筛选
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowFiltering();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowFormattingCells()"><!-- --></A><H3>
isAllowFormattingCells</H3>
<PRE>
public boolean <B>isAllowFormattingCells</B>()</PRE>
<DL>
<DD>是否允许格式化单元格。如果为 True，则允许用户为受保护的工作表上的任意单元格设置格式。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许格式化单元格
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许格式化单元格
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowFormattingCells();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowFormattingColumns()"><!-- --></A><H3>
isAllowFormattingColumns</H3>
<PRE>
public boolean <B>isAllowFormattingColumns</B>()</PRE>
<DL>
<DD>是否允许格式化列。如果为 True，则允许用户为受保护的工作表上的任意列设置格式。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许格式化列
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许格式化列
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowFormattingColumns();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowFormattingRows()"><!-- --></A><H3>
isAllowFormattingRows</H3>
<PRE>
public boolean <B>isAllowFormattingRows</B>()</PRE>
<DL>
<DD>是否允许格式化行。如果为 True，则允许用户为受保护的工作表上的任意行设置格式。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许格式化行
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许格式化行
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowFormattingRows();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowInsertingColumns()"><!-- --></A><H3>
isAllowInsertingColumns</H3>
<PRE>
public boolean <B>isAllowInsertingColumns</B>()</PRE>
<DL>
<DD>是否允许插入列。如果为 True，则允许用户在受保护的工作表上插入列。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许插入列
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许插入列
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowInsertingColumns();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowInsertingHyperlinks()"><!-- --></A><H3>
isAllowInsertingHyperlinks</H3>
<PRE>
public boolean <B>isAllowInsertingHyperlinks</B>()</PRE>
<DL>
<DD>是否允许插入超链接。如果为 True，则允许用户在受保护的工作表中插入超链接。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许插入超链接
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许插入超链接
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowInsertingHyperlinks();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowInsertingRows()"><!-- --></A><H3>
isAllowInsertingRows</H3>
<PRE>
public boolean <B>isAllowInsertingRows</B>()</PRE>
<DL>
<DD>是否允许插入行。如果为 True，则允许用户在受保护的工作表上插入行。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许插入行
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许插入行
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowInsertingRows();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowSorting()"><!-- --></A><H3>
isAllowSorting</H3>
<PRE>
public boolean <B>isAllowSorting</B>()</PRE>
<DL>
<DD>是否允许排序。如果为 True，则允许用户在受保护的工作表上进行排序。排序区域中的每个单元格必须是解除锁定的或取消保护的。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许排序
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许排序
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowSorting();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isAllowUsingPivotTables()"><!-- --></A><H3>
isAllowUsingPivotTables</H3>
<PRE>
public boolean <B>isAllowUsingPivotTables</B>()</PRE>
<DL>
<DD>是否允许使用数据透视表。如果为 True，则允许用户在受保护的工作表上使用数据透视表。
<P>
<DD><DL>

<DT><B>返回：</B><DD>返回是否允许使用数据透视表
 <p>
 <b>例子: </b>
 <pre>
 //查看当前工作表保护中是否允许使用数据透视表
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = worksheet.getProtectProperties();
 boolean flag = protectProperties.isAllowUsingPivotTables();
 System.out.println(flag);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="setAllowDeleteColumns(boolean)"><!-- --></A><H3>
setAllowDeleteColumns</H3>
<PRE>
public void <B>setAllowDeleteColumns</B>(boolean&nbsp;b)</PRE>
<DL>
<DD>是否允许删除列。如果为 True，则允许用户在受保护的工作表上删除列，要删除的列中的每个单元格都是解除锁定的。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>b</CODE> - true为允许删除列
 <p>
 <b>例子: </b>
 <pre>
 //保护当前工作表,密码为"aa",并允许删除列
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 ProtectProperties protectProperties = new ProtectProperties();
 protectProperties.setAllowDeleteColumns(true);
 boolean flag = worksheet.protect("aa", protectProperties);
 System.out.println(flag);
 </pre></DL>