revisions.html

永中OFFICE二次开发帮助文档

 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 Section section = doc.getSection(0);
 doc.beginTrackRevision();
 BaseText baseText = section.getBaseText();
 baseText.insertText(0,"this is a test!");
 doc.stopTrackRevision();
 Revisions revisions = doc.getRevisions();
 System.out.println("修订状态下新插入文本的显示格式: " + revisions.getInsertMark());
 </pre><DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/RevisionsConstants.html" title="application.constants 中的接口"><CODE>RevisionsConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getMeasureType()"><!-- --></A><H3>
getMeasureType</H3>
<PRE>
public int <B>getMeasureType</B>()</PRE>
<DL>
<DD>返回单位度量的方式。如果当前批注框的视图类型为“从不”，则返回-1。
<P>
<DD><DL>

<DT><B>返回：</B><DD>单位的度量方式，只能取以下值之一为：
 <pre>
 RevisionsConstants.PERCENT  百分比
 RevisionsConstants.MEASURE  绝对单位（默认为磅值）
 </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);
 doc.stopTrackRevision();
 System.out.println("返回批注框的单位度量方式：" + revisions.getMeasureType());
 </pre><DT><B>另请参见：</B><DD><A HREF="../../../../../application/workbooks/workbook/documents/document/Revisions.html#setMeasureType(int)"><CODE>setMeasureType(int)</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/documents/document/Revisions.html#getCommentWidth()"><CODE>getCommentWidth()</CODE></A>, 
<A HREF="../../../../../application/constants/RevisionsConstants.html" title="application.constants 中的接口"><CODE>RevisionsConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getRevision(int)"><!-- --></A><H3>
getRevision</H3>
<PRE>
public <A HREF="../../../../../application/workbooks/workbook/documents/document/trackchanges/Revision.html" title="application.workbooks.workbook.documents.document.trackchanges 中的类">Revision</A> <B>getRevision</B>(int&nbsp;index)</PRE>
<DL>
<DD>得到指定的修订信息。每一个修订信息代表某一个标有修订标记的变化。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 指定的索引值。修订的索引值是根据修订内容所在文档中的位置为顺序排序的。
<DT><B>返回：</B><DD>返回指定索引的修订信息
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 doc.beginTrackRevision();
 BaseText baseText = doc.getBaseText();
 baseText.insertText(0,"this is a test!");
 doc.stopTrackRevision();
 Revisions revisions = doc.getRevisions();
 Revision revision = revisions.getRevision(0);
 System.out.println("返回本次修订的作者为"+ revision.getAuthor());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getViewType()"><!-- --></A><H3>
getViewType</H3>
<PRE>
public int <B>getViewType</B>()</PRE>
<DL>
<DD>返回文档的修订状态。
<P>
<DD><DL>

<DT><B>返回：</B><DD>文档的修订状态，取值如下：
 <pre>
                RevisionsConstants.FINAL_SHOWING_MARKUP      0     显示标记的最终状态
                RevisionsConstants.FINAL                     1     最终状态
                RevisionsConstants.ORIGINAL_SHOWING_MARKUP   2     显示标记的原始状态
                RevisionsConstants.ORIGINAL                  3     原始状态        
 </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.setViewType(RevisionsConstants.ORIGINAL);
 doc.beginTrackRevision();
 baseText.insertText(0,"new");
 doc.stopTrackRevision();
 System.out.println("viewType=" + revision.getViewType());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isLineVisible()"><!-- --></A><H3>
isLineVisible</H3>
<PRE>
public boolean <B>isLineVisible</B>()</PRE>
<DL>
<DD>返回是否显示与文字的连接线。
<P>
<DD><DL>

<DT><B>返回：</B><DD>是否显示与文字的连接线
 <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);
 doc.stopTrackRevision();
 System.out.println("是否显示与文字的连接线：" + revisions.isLineVisible());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="rejectAll()"><!-- --></A><H3>
rejectAll</H3>
<PRE>
public void <B>rejectAll</B>()</PRE>
<DL>
<DD>拒绝当前文档或某一个文本范围内的所有修订动作。将删除修订标记，不改变原文。
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 doc.beginTrackRevision();
 BaseText baseText = doc.getBaseText();
 baseText.insertText(0,"this is a test!");
 FontAttribute font = new FontAttribute();
 font.setBold(true);
 font.setFontSize(18.0f);
 baseText.setFontAttribute(2,4,font);
 doc.stopTrackRevision();
 Revisions revisions = doc.getRevisions();
 revisions.rejectAll();
 </pre>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setChangeColor(int)"><!-- --></A><H3>
setChangeColor</H3>
<PRE>
public void <B>setChangeColor</B>(int&nbsp;index)</PRE>
<DL>
<DD>设置标记修订时，标记修订线颜色。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 标记修订线的颜色的索引值，取值如下：
 <pre>      
     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.insertParagraph(0);
 revisions.setChangeColor(RevisionsConstants.GREEN);
 baseText.insertParagraph(0);
 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="setChangeMark(int)"><!-- --></A><H3>
setChangeMark</H3>
<PRE>
public void <B>setChangeMark</B>(int&nbsp;index)</PRE>
<DL>
<DD>设置标记修订时，标记修订行的显示格式。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 修订行的显示格式的索引值
 <pre> 
 RevisionsConstants.NONE              无标志
 RevisionsConstants.LEFT_BORDER       左侧框线
 RevisionsConstants.RIGHT_BORDER      右侧框线
 RevisionsConstants.OUTSIDE_BORDER    外侧框线  
 </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.insertParagraph(0);
 revisions.setChangeMark(RevisionsConstants.RIGHT_BORDER);
 baseText.insertParagraph(0);
 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="setCommentAlignment(int)"><!-- --></A><H3>
setCommentAlignment</H3>
<PRE>
public void <B>setCommentAlignment</B>(int&nbsp;alignment)</PRE>
<DL>
<DD>设置批注框的边距类型。如果当前批注框的视图类型为“从不”，则设置批注框的边距类型无效。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>alignment</CODE> - 批注框的边距类型
 <pre>
 取值范围：
 RevisionsConstants.LEFT    靠左
 RevisionsConstants.RIGHT   靠右
 </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.ONLY_FOR_COMMENT_FORMATTING);
 revisions.setCommentAlignment(RevisionsConstants.LEFT);
 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="setCommentPrintType(int)"><!-- --></A><H3>
setCommentPrintType</H3>
<PRE>
public void <B>setCommentPrintType</B>(int&nbsp;index)</PRE>
<DL>
<DD>设置批注框的打印类型。如果当前批注框的视图类型为“从不”，则设置批注框的打印类型无效。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 批注框的打印类型
 <pre>
 取值范围：
 RevisionsConstants.AUTO                   自动
 RevisionsConstants.PRESERVE               保留
 RevisionsConstants.FORCE_LANDSCAPE        强制横向
 </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.ONLY_FOR_COMMENT_FORMATTING);
 revisions.setCommentPrintType(RevisionsConstants.PRESERVE);
 doc.beginTrackRevision();
 FontAttribute font = new FontAttribute();
 font.setBold(true);
 font.setFontSize(18.0f);
 baseText.setFontAttribute(0,3,font);