软航科技文档中心

Appearance

软航OFFICE文档控件国产化版本开发接口 ​

重要说明

本文档仅作在线参考使用，不保证文档功能和版本的正确性描述。
实际开发时请以官方最新文档和产品说明为准。

产品简介 ​

软航OFFICE文档控件国产化版本是专为国产化环境设计的Office文档处理解决方案，提供完整的文档编辑、预览、打印等功能，支持国产操作系统和浏览器环境。

核心功能 ​

  • 在线编辑：支持在浏览器中直接编辑Word、Excel、PowerPoint等Office文档
  • 文档管理：实现文档的统一管理和保存到Web服务器
  • 痕迹保留：支持文档修改痕迹的完整记录和显示
  • 电子签章：提供安全可靠的电子签章解决方案
  • 手写签名：支持手写签名和意见批注功能
  • 版式文档：支持OFD/PDF、TIF版式文档的阅读
  • 二维码支持：支持添加一维码和二维码功能
  • 图片处理：支持图片的插入、编辑和处理

技术特性 ​

  • 国产化支持：专为国产操作系统和浏览器环境优化
  • 跨平台支持：支持国产操作系统（Linux等）
  • 浏览器兼容：支持360、奇安信、红莲花、UOS等国产浏览器
  • 多格式支持：支持WPS、ET、DPS国产办公软件格式
  • 所见即所得：支持所见打印效果的版式文档阅读
  • 异步处理：支持异步方法调用和回调机制

系统要求 ​

操作系统 ​

  • 国产操作系统（Linux等）

浏览器支持 ​

  • 360浏览器
  • 奇安信浏览器
  • 红莲花浏览器
  • UOS浏览器
  • 其他国产浏览器

开发环境 ​

  • 支持所有符合HTTP/1.1标准的Web服务器
  • 支持各种后台Web服务器和编程语言
  • 通过JavaScript控制文档操作

HTML Object标识符 ​

国产化版本标识符 ​

html
<object name='webwps' id='webwps_id' type='application/ntko-plug' 
        data='/opt/kingsoft/wps-office/office6/mui/default/templates/Normal.dotm' 
        width='1000' height='600' _FileNew=false>
</object>

事件绑定示例 ​

html
<object name='webwps' id='webwps_id' type='application/ntko-plug' 
        data='/opt/kingsoft/wps-office/office6/mui/default/templates/Normal.dotm' 
        width='1000' height='600' _FileNew=false
        ForOnDocumentOpened='OnDocumentOpened'
        ForOnDocumentClosed='OnDocumentClosed'
        ForOnCustomMenuCmd2='OnCustomMenuCmd2'
        ForOnCustomToolBarCommand='OnCustomToolBarCommand'>
</object>

开发优势 ​

  • 国产化适配：专为国产化环境优化，支持国产操作系统和浏览器
  • 卓越性能：高效的文档处理能力，支持大文件处理
  • 标准接口：提供标准高效的编程接口，易于集成
  • 开发成本低：以最低的开发成本创建特色解决方案
  • OA系统最佳选择：是办公自动化系统开发的最佳选择组件
  • 异步支持：支持异步方法调用，提升用户体验
  • 安全可靠：符合国产化安全要求，支持国产加密算法

文档结构 ​

本开发接口参考文档包含以下主要内容：

属性参考 ​

方法参考 ​

事件处理 ​

高级功能 ​

快速开始 ​

基本使用示例 ​

javascript
// 文档打开事件
function OnDocumentOpened(doc, file) {
    console.log("文档已打开：", file);
    // 处理文档打开后的操作
}

// 文档关闭事件
function OnDocumentClosed() {
    console.log("文档已关闭");
    // 处理文档关闭后的操作
}

// 自定义菜单命令事件
function OnCustomMenuCmd2(menuPos, submenuPos, subsubmenuPos, menuCaption, myMenuID) {
    console.log("菜单命令：", menuCaption, myMenuID);
    // 处理菜单命令
}

// 自定义工具栏按钮事件
function OnCustomToolBarCommand(buttonIndex) {
    console.log("工具栏按钮：", buttonIndex);
    // 处理工具栏按钮点击
}

常用操作 ​

javascript
// 添加自定义工具栏按钮
var buttonIndex = OCX_OBJ.AddCustomToolButton("新建", 3);
OCX_OBJ.SetCustomToolButtonStatus(buttonIndex, true, true);

// 添加自定义菜单
OCX_OBJ.AddCustomMenu2(0, "工具菜单");
OCX_OBJ.AddCustomMenuItem2(0, 0, -1, false, "工具1", false, 100);

// 添加二维码
OCX_OBJ.Add2DCodePic(2, "https://www.example.com", true, 100, 100, 1, 100, 1, false);

// 插入图片
OCX_OBJ.AddPicFromLocal("C:\\images\\photo.jpg", false, true, 0, 0, 1, 100, 1, false, false);

使用建议

建议开发者按照文档结构逐步学习，从基础属性开始，逐步掌握高级功能的使用方法。国产化版本特别需要注意异步方法调用的回调处理。

Copyright © 2025 软航科技