revisions.html

永中OFFICE二次开发帮助文档

 doc.stopTrackRevision();
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当指定的常量不存在。<DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/RevisionsConstants.html" title="application.constants 中的接口"><CODE>RevisionsConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setCommentViewType(int)"><!-- --></A><H3>
setCommentViewType</H3>
<PRE>
public void <B>setCommentViewType</B>(int&nbsp;type)</PRE>
<DL>
<DD>设置批注框的视图类型。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>type</CODE> - 批注框的视图类型
 <p>
 <b>例子:</b>
 <pre>
 取值范围：
 RevisionsConstants.ALWAYS                          总是
 RevisionsConstants.NEVER                           从不
 RevisionsConstants.ONLY_FOR_COMMENT_FORMATTING     仅用于批注/格式
 </pre>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 Section section = doc.getSection(0);
 BaseText baseText = section.getBaseText();
 baseText.insertText(0,"this is a test!");
 Revisions revisions = doc.getRevisions();
 revisions.setCommentViewType(RevisionsConstants.NEVER);
 doc.beginTrackRevision();
 FontAttribute font = new FontAttribute();
 font.setBold(true);
 font.setFontSize(18.0f);
 baseText.setFontAttribute(0,3,font);
 doc.stopTrackRevision();
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当指定的常量不存在。<DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/RevisionsConstants.html" title="application.constants 中的接口"><CODE>RevisionsConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setCommentVisible(boolean)"><!-- --></A><H3>
setCommentVisible</H3>
<PRE>
public void <B>setCommentVisible</B>(boolean&nbsp;visible)</PRE>
<DL>
<DD>设置修订时是否显示批注。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>visible</CODE> - 是否显示批注
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 Section section = doc.getSection(0);
 BaseText baseText = section.getBaseText();
 baseText.insertText(0,"this is a test!");
 Revisions revisions = doc.getRevisions();
 revisions.setCommentVisible(false);
 doc.beginTrackRevision();
 FontAttribute font = new FontAttribute();
 font.setBold(true);
 font.setFontSize(18.0f);
 baseText.setFontAttribute(0,3,font);
 doc.stopTrackRevision();
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="setCommentWidth(float)"><!-- --></A><H3>
setCommentWidth</H3>
<PRE>
public void <B>setCommentWidth</B>(float&nbsp;width)</PRE>
<DL>
<DD>设置批注框的宽度。如果当前批注框的视图类型为“从不”，则设置批注框的宽度无效。
 说明：宽度值依据批注框宽度的度量方式来设置。度量方式有百分比和绝对单位（默认取磅值）两种。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>width</CODE> - 批注框的宽度。依据百分比或绝对单位来取值。如果度量单位为百分比，则宽度值范围在0到100之间；
 如果为绝对单位，则默认取磅值，宽度值的范围在0到1100.7磅之间
 说明：set方法的参数默认取磅值，如果要用其他的度量单位（英寸、厘米、毫米、十二点活字），
 可以用 application.util.Utilities.otherToPoint(double, int)方法将其他度量单位转换为磅值后再调用相应的设置方法。
 <p>
 <b>例子:</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 Section section = doc.getSection(0);
 BaseText baseText = section.getBaseText();
 baseText.insertText(0,"this is a test!");
 Revisions revisions = doc.getRevisions();
 revisions.setCommentViewType(RevisionsConstants.ONLY_FOR_COMMENT_FORMATTING);
 revisions.setMeasureType(RevisionsConstants.MEASURE);
 revisions.setCommentWidth(100.0f);
 doc.beginTrackRevision();
 FontAttribute font = new FontAttribute();
 font.setBold(true);
 font.setFontSize(18.0f);
 baseText.setFontAttribute(0,3,font);
 doc.stopTrackRevision();
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 指定的宽度超出范围。<DT><B>另请参见：</B><DD><A HREF="../../../../../application/workbooks/workbook/documents/document/Revisions.html#getCommentWidth()"><CODE>getCommentWidth()</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/documents/document/Revisions.html#setMeasureType(int)"><CODE>setMeasureType(int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setDeleteColor(int)"><!-- --></A><H3>
setDeleteColor</H3>
<PRE>
public void <B>setDeleteColor</B>(int&nbsp;index)</PRE>
<DL>
<DD>设置标记修订时，标记被删除文本的颜色。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 被删除文本的颜色的索引值，取值如下：
 <pre>
     RevisionsConstants.BY_AUTHOR       颜色（根据作者）
     RevisionsConstants.AUTOMATIC       颜色（自动） 
     RevisionsConstants.BLACK           黑色
     RevisionsConstants.BLUE            蓝色
     RevisionsConstants.TURQUOUISE      青绿色
     RevisionsConstants.DARK_GRAY       深灰色
     RevisionsConstants.GRAY            灰色
     RevisionsConstants.BRIGHT_GREEN    亮绿色
     RevisionsConstants.LIGHT_GRAY      浅灰色
     RevisionsConstants.MAGENTA         洋红色
     RevisionsConstants.GOLD            金色
     RevisionsConstants.PRINK           粉红色
     RevisionsConstants.RED             红色
     RevisionsConstants.WHITE           白色
     RevisionsConstants.YELLOW          黄色
     RevisionsConstants.DARK_BLUE       深蓝色
     RevisionsConstants.TEAL            青色
     RevisionsConstants.GREEN           绿色
     RevisionsConstants.VIOLET          紫罗兰色
     RevisionsConstants.DARK_RED        暗红色
     RevisionsConstants.DARK_YELLOW     暗黄色
 </pre> 
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 Section section = doc.getSection(0);
 BaseText baseText = section.getBaseText();
 baseText.insertText(0,"this is a test!");
 Revisions revisions = doc.getRevisions();
 doc.beginTrackRevision();
 baseText.delete(0,3);
 revisions.setDeleteColor(RevisionsConstants.BRIGHT_GREEN);
 baseText.delete(0,3");
 doc.stopTrackRevision();
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当指定的常量不存在或不适用<DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/RevisionsConstants.html" title="application.constants 中的接口"><CODE>RevisionsConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setDeleteMark(int)"><!-- --></A><H3>
setDeleteMark</H3>
<PRE>
public void <B>setDeleteMark</B>(int&nbsp;index)</PRE>
<DL>
<DD>设置标记修订时，标记被删除文本的显示格式。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 被删除文本的显示格式的索引值
 <pre> 
 RevisionsConstants.NONE             无标志
 RevisionsConstants.ONLY_COLOR       仅颜色
 RevisionsConstants.BOLD             加粗标志
 RevisionsConstants.ITALIC           斜体标志
 RevisionsConstants.SOLID_UNDERLINE  下划线标志
 RevisionsConstants.DOUBLE_UNDERLINE 双下划线标志
 RevisionsConstants.STRIKE_THROUGH   显示删除线
 RevisionsConstants.HIDDEN           隐藏删除的文本     
 </pre>
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 Section section = doc.getSection(0);
 BaseText baseText = section.getBaseText();
 baseText.insertText(0,"this is a test!");
 Revisions revisions = doc.getRevisions();
 doc.beginTrackRevision();
 baseText.delete(0,3);
 revisions.setDeleteMark(RevisionsConstants.STRIKE_THROUGH);
 baseText.delete(0,3");
 doc.stopTrackRevision();
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当指定的常量不存在或不适用<DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/RevisionsConstants.html" title="application.constants 中的接口"><CODE>RevisionsConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setFormatColor(int)"><!-- --></A><H3>
setFormatColor</H3>
<PRE>
public void <B>setFormatColor</B>(int&nbsp;index)</PRE>
<DL>
<DD>设置标记修订时，标记改变过格式的文本的颜色。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 被格式化文本的颜色的索引值，取值如下：
  <pre>
     RevisionsConstants.BY_AUTHOR       颜色（根据作者）
     RevisionsConstants.AUTOMATIC       颜色（自动） 
     RevisionsConstants.BLACK           黑色
     RevisionsConstants.BLUE            蓝色
     RevisionsConstants.TURQUOUISE      青绿色
     RevisionsConstants.DARK_GRAY       深灰色
     RevisionsConstants.GRAY            灰色
     RevisionsConstants.BRIGHT_GREEN    亮绿色
     RevisionsConstants.LIGHT_GRAY      浅灰色
     RevisionsConstants.MAGENTA         洋红色
     RevisionsConstants.GOLD            金色
     RevisionsConstants.PRINK           粉红色
     RevisionsConstants.RED             红色
     RevisionsConstants.WHITE           白色
     RevisionsConstants.YELLOW          黄色
     RevisionsConstants.DARK_BLUE       深蓝色
     RevisionsConstants.TEAL            青色
     RevisionsConstants.GREEN           绿色
     RevisionsConstants.VIOLET          紫罗兰色
     RevisionsConstants.DARK_RED        暗红色
     RevisionsConstants.DARK_YELLOW     暗黄色
 </pre> 
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 Section section = doc.getSection(0);
 BaseText baseText = section.getBaseText();
 baseText.insertText(0,"this is a test!");
 Revisions revisions = doc.getRevisions();
 doc.beginTrackRevision();
 FontAttribute font = new FontAttribute();
 font.setBold(true);
 font.setFontSize(18.0f);
 baseText.setFontAttribute(0,3,font);
 revisions.setFormatColor(RevisionsConstants.BRIGHT_GREEN);
 baseText.setFontAttribute(6,3,font);
 doc.stopTrackRevision();
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当指定的常量不存在或不适用<DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/RevisionsConstants.html" title="application.constants 中的接口"><CODE>RevisionsConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setFormatMark(int)"><!-- --></A><H3>
setFormatMark</H3>
<PRE>
public void <B>setFormatMark</B>(int&nbsp;index)</PRE>
<DL>
<DD>设置标记修订时，标记改变过格式的文本的显示格式。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 被格式文本的显示格式的索引值
 <pre> 
 RevisionsConstants.NONE             无标志
 RevisionsConstants.ONLY_COLOR       仅颜色
 RevisionsConstants.BOLD             加粗标志
 RevisionsConstants.ITALIC           斜体标志
 RevisionsConstants.SOLID_UNDERLINE  下划线标志
 RevisionsConstants.DOUBLE_UNDERLINE 双下划线标志
 </pre>
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 Section section = doc.getSection(0);
 BaseText baseText = section.getBaseText();
 baseText.insertText(0,"this is a test!");
 Revisions revisions = doc.getRevisions();
 doc.beginTrackRevision();
 FontAttribute font = new FontAttribute();
 font.setBold(true);
 font.setFontSize(18.0f);
 baseText.setFontAttribute(0,3,font);
 revisions.setFormatMark(RevisionsConstants.ONLY_COLOR);
 baseText.setFontAttribute(6,3,font);
 doc.stopTrackRevision();
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当指定的常量不存在或不适用<DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/RevisionsConstants.html" title="application.constants 中的接口"><CODE>RevisionsConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setInsertColor(int)"><!-- --></A><H3>
setInsertColor</H3>
<PRE>
public void <B>setInsertColor</B>(int&nbsp;index)</PRE>
<DL>
<DD>设置标记修订时，标记新插入文本的颜色。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 新插入文本的颜色的索引值，取值如下：
 <pre>
     RevisionsConstants.BY_AUTHOR       颜色（根据作者）
     RevisionsConstants.AUTOMATIC       颜色（自动） 
     RevisionsConstants.BLACK           黑色
     RevisionsConstants.BLUE            蓝色
     RevisionsConstants.TURQUOUISE      青绿色
     RevisionsConstants.DARK_GRAY       深灰色
     Revi