application.html

永中OFFICE二次开发帮助文档

 //在控制台上输出永中集成Office状态。
 System.out.println(Application.getMainFrameStatus());
 </pre><DT><B>另请参见：</B><DD><A HREF="../application/Application.html#setMainFrameStatus(int)"><CODE>setMainFrameStatus(int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getOptions()"><!-- --></A><H3>
getOptions</H3>
<PRE>
public static <A HREF="../application/Options.html" title="application 中的类">Options</A> <B>getOptions</B>()</PRE>
<DL>
<DD>得到Options对象。
 <p>
 Options对象即对应office界面上工具菜单中的选项对话框。
 <p>
<P>
<DD><DL>

<DT><B>返回：</B><DD>Options对象
 <p>
 <b>例子：</b>
 <pre>
 //设置新建一个永中集成Office文件时,自动进入的默认应用程序为电子表格。
 Application.getOptions().setDefaultApplication(0);
 </pre><DT><B>另请参见：</B><DD><A HREF="../application/Options.html" title="application 中的类"><CODE>Options</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getOS()"><!-- --></A><H3>
getOS</H3>
<PRE>
public static int <B>getOS</B>()</PRE>
<DL>
<DD>判断当前应用程序在哪个类型的操作系统环境下运行。
<P>
<DD><DL>

<DT><B>返回：</B><DD>操作系统的类型，只能取以下常量值：
 <pre>
                GlobalConstants.WINDOWS = 0    运行环境为WINDOWS操作系统
                GlobalConstants.LINUX = 1      运行环境为LINUX操作系统
                GlobalConstants.MACINTOSH = 2  运行环境为苹果电脑操作系统
                GlobalConstants.UNKNOWN = -1   运行环境为未知操作系统
 </pre>
 <p>
 <b>例子:</b>
 <pre>
 int os = Application.getOS();
 System.out.println("永中集成Office当前运行的操作系统是否为WINDOWS：" + (os == GlobalConstants.WINDOWS));
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getPreviewIcon(java.lang.String)"><!-- --></A><H3>
getPreviewIcon</H3>
<PRE>
public static javax.swing.ImageIcon <B>getPreviewIcon</B>(java.lang.String&nbsp;filePath)</PRE>
<DL>
<DD>返回预览图片文件的Icon。
 <p>
 需要在文件属性中设置保存预览图片。
 <p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>filePath</CODE> - 文件名绝对路径
 <p>
 <b>例子:</b>
 <pre>
 //在控制台上输出预览图片文件的描述。
 ImageIcon icon = Application.getPreviewIcon("d:/aaa.eio");
 System.out.println(icon.getDescription());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getSystemPath(int)"><!-- --></A><H3>
getSystemPath</H3>
<PRE>
public static java.lang.String <B>getSystemPath</B>(int&nbsp;type)</PRE>
<DL>
<DD>获取永中集成Office文件的系统路径。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>type</CODE> - 路径类型：
 <pre>
          GlobalConstants.TYPE_SYSTEM_DOCUMENT_PATH     = 0 默认存盘文件夹的路径；
          GlobalConstants.TYPE_SYSTEM_PICTURE_PATH      = 1 默认图片存盘路径
          GlobalConstants.TYPE_SYSTEM_MUSIC_PATH        = 2 默认音频存盘路径
          GlobalConstants.TYPE_SYSTEM_VIDEO_PATH        = 3 默认视频存盘路径
          GlobalConstants.TYPE_USER_APPDATA_PATH        = 4 永中集成Office在当前用户目录路径
          GlobalConstants.TYPE_USER_PATH                = 5 当前用户目录路径
          GlobalConstants.TPYE_USER_TEMP_PATH           = 6 默认临时文件存盘路径；
          GlobalConstants.TPYE_EIO_INSTALL_PATH         = 7 永中集成Office安装路径；
 </pre>
<DT><B>返回：</B><DD>路径名
 <p>
 <b>例子：</b>
 <pre> 
 //获取默认临时文件存盘路径并在控制台上显示。
 String path = Application.getSystemPath(GlobalConstants.TPYE_USER_TEMP_PATH);
 System.out.println(path);
 </pre><DT><B>从以下版本开始：</B></DT>
  <DD>1.33</DD>
<DT><B>另请参见：</B><DD><A HREF="../application/constants/GlobalConstants.html" title="application.constants 中的接口"><CODE>GlobalConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getVersion()"><!-- --></A><H3>
getVersion</H3>
<PRE>
public static java.lang.String <B>getVersion</B>()</PRE>
<DL>
<DD>返回永中集成Office软件的版本号。
<P>
<DD><DL>

<DT><B>返回：</B><DD>永中集成Office软件的版本号
 <p>
 <b>例子:</b>
 <pre>
 //在控制台上输出此永中集成Office软件的版本号。
 String message = Application.getVersion();
 System.out.println(message);
 </pre><DT><B>从以下版本开始：</B></DT>
  <DD>1.32</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getWindows()"><!-- --></A><H3>
getWindows</H3>
<PRE>
public static <A HREF="../application/Windows.html" title="application 中的类">Windows</A> <B>getWindows</B>()</PRE>
<DL>
<DD>获取永中集成Office窗体管理器。
<P>
<DD><DL>

<DT><B>返回：</B><DD>永中集成Office窗体管理器
 <p>
 <b>例子：</b>
 <pre>
 //对当前永中集成Office窗体重新设置大小。
 Windows windows = Application.getWindows();
 Window win = windows.getActiveWindow();
 win.resize(100,300);
 </pre><DT><B>另请参见：</B><DD><A HREF="../application/Windows.html" title="application 中的类"><CODE>Windows</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getWorkbooks()"><!-- --></A><H3>
getWorkbooks</H3>
<PRE>
public static <A HREF="../application/Workbooks.html" title="application 中的类">Workbooks</A> <B>getWorkbooks</B>()</PRE>
<DL>
<DD>获取永中集成Office集成文件管理器。
<P>
<DD><DL>

<DT><B>返回：</B><DD>永中集成Office集成文件管理器
 <p>
 <b>例子：</b>
 <pre>
 //获取集成文件管理器并新建一文字处理集成文件。
 Workbooks books = Application.getWorkbooks();
 books.addWorkbook(GlobalConstants.WORDPROCESSOR);
 </pre><DT><B>另请参见：</B><DD><A HREF="../application/Workbooks.html" title="application 中的类"><CODE>Workbooks</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="gotoProduct(int)"><!-- --></A><H3>
gotoProduct</H3>
<PRE>
public static void <B>gotoProduct</B>(int&nbsp;type)</PRE>
<DL>
<DD>定位到某个应用。
 <p>
 当没有此应用时则新建该应用。
 <p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>type</CODE> - 应用类型，只能取以下三值之一：
 <pre>
          GlobalConstants.SPREADSHEET   = 0 电子表格；
          GlobalConstants.WORDPROCESSOR = 1 文字处理；
          GlobalConstants.PRESENTATION  = 2 简报制作；
 </pre>
 <p>
 <b>例子：</b>
 <pre>
 //定位到电子表格应用。
 Application.gotoProduct(GlobalConstants.SPREADSHEET);
 </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/GlobalConstants.html" title="application.constants 中的接口"><CODE>GlobalConstants</CODE></A>, 
<A HREF="../application/Application.html#getActiveProductType()"><CODE>getActiveProductType()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="hideApplicationBar()"><!-- --></A><H3>
hideApplicationBar</H3>
<PRE>
public static void <B>hideApplicationBar</B>()</PRE>
<DL>
<DD>不显示永中集成Office应用切换条。
 <p>
 仅在永中集成Office初始化前使用。
 <p>
 <b>例子：</b>
 <pre>
 //打开一个永中集成Office应用程序并设置不显示永中集成Office应用切换条。
 Application.hideApplicationBar();
 Application.getApplicationInstance();
 </pre>
<P>
<DD><DL>
<DT><B>另请参见：</B><DD><A HREF="../application/Application.html#hideTaskPane(int)"><CODE>hideTaskPane(int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="hideTaskPane(int)"><!-- --></A><H3>
hideTaskPane</H3>
<PRE>
public static void <B>hideTaskPane</B>(int&nbsp;popeID)</PRE>
<DL>
<DD>隐藏永中集成Office的任务面板(开始工作、新建、导航面板、科教面板、剪贴板）。
 <p>
 仅在永中集成Office初始化前使用。在调用该方法后不能再通过UI界面和API在所起的永中集成Office中显示此任务面板。
 <p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>popeID</CODE> - barNo为任务面板的序号，只能取以下值之一：
 <pre>      
      GlobalConstants.START_WORK_PANE   开始工作
      GlobalConstants.NEW_DOCUMENT_PANE 新建
      GlobalConstants.NAVIGATION_PANE   导航面板
      GlobalConstants.EQUATION_PANE     科教面板
      GlobalConstants.CLIPBOARD_PANE    剪贴板
 </pre>
 <p>
 <b>例子：</b>
 <pre>
 //打开一个永中集成Office应用程序并设置隐藏永中集成Office的开始工作任务面板。
 Application.hideTaskPane(GlobalConstants.START_WORK_PANE);
 Application.getApplicationInstance();
 </pre><DT><B>另请参见：</B><DD><A HREF="../application/Application.html#hideApplicationBar()"><CODE>hideApplicationBar()</CODE></A>, 
<A HREF="../application/constants/GlobalConstants.html" title="application.constants 中的接口"><CODE>GlobalConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="isActionEnable(int)"><!-- --></A><H3>
isActionEnable</H3>
<PRE>
public static boolean <B>isActionEnable</B>(int&nbsp;index)</PRE>
<DL>
<DD>判定某个菜单项是否有效。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 根据index的值，来判断哪个菜单有效　
 <pre>
 ActionNameConstants.FILE_NEW               = (文件新建)
 ActionNameConstants.FILE_OPEN              = (文件打开)
 ActionNameConstants.FILE_CLOSE             = (文件关闭)
 ActionNameConstants.FILE_SAVE              = (文件保存)
 ActionNameConstants.FILE_SAVE_AS           = (文件另存为)
 ActionNameConstants.INSERT_HYPERLINK       = (插入超链接)
 ActionNameConstants.VIEW_TASKPANE          = (视图导航面板)
 ...
 </pre>
<DT><B>返回：</B><DD>返回一个boolean　若为true　菜单有效，否则无效
 <p>
 <b>例子：</b>
 <pre>
 //在控制台上输出插入超链接菜单项是否有效。
 System.out.print(Application.isActionEnable(ActionNameConstants.INSERT_HYPERLINK));    
 </pre><DT><B>另请参见：</B><DD><A HREF="../application/constants/ActionNameConstants.html" title="application.constants 中的接口"><CODE>ActionNameConstants</CODE></A>, 
<A HREF="../application/Application.html#setActionEnable(int, boolean)"><CODE>setActionEnable(int, boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="isFormulaBarVisible()"><!-- --></A><H3>
isFormulaBarVisible</H3>
<PRE>
public static boolean <B>isFormulaBarVisible</B>()</PRE>
<DL>
<DD>得到是否显示编辑栏。
<P>
<DD><DL>

<DT><B>返回：</B><DD>布尔型，若为true，显示编辑栏；否则，不显示编辑栏
 <p>
 <b>例子:</b>
 <pre>
 //在控制台上输出是否显示编辑栏
 System.out.println(Application.isFormulaBarVisible());
 </pre><DT><B>另请参见：</B><DD><A HREF="../application/Application.html#setFormulaBarVisible(boolean)"><CODE>setFormulaBarVisible(boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="isFullScreenVisible()"><!-- --></A><H3>
isFullScreenVisible</H3>
<PRE>
public static boolean <B>isFullScreenVisible</B>()</PRE>
<DL>
<DD>得到全屏显示窗口的状态。
<P>
<DD><DL>

<DT><B>返回：</B><DD>布尔型，若为true，窗口为全屏状态；否则，窗口为原来的状态
 <p>
 <b>例子:</b>
 <pre>
 //在控制台上输出是否处于全屏的状态。
 System.out.println(Application.isFullScreenVisible());
 </pre><DT><B>另请参见：</B><DD><A HREF="../application/Application.html#setFullScreenVisible(boolean)"><CODE>setFullScreenVisible(boolean)</CODE></A></DL>
</DD>
</DL>