PDF插件主要方法参考

概述

本节介绍软航OFFICE文档控件PDF插件的主要方法，这些方法允许开发者控制PDF文档的各种功能和行为，为PDF文档管理系统提供完整的方法控制能力。

视图控制方法

ShowSidebar

语法：

javascript

ShowSidebar(bShow, sidbarId)

功能：
控制显示或者隐藏文档视图的侧边栏。

参数：

名称	必选/可选	数据类型	说明
bShow	必选	bool	是否显示侧边栏
sidbarId	必选	long	侧边栏ID

返回值：
无返回值

说明：
通过PDF插件的ShowSidebar方法，可以控制显示或者隐藏文档视图的侧边栏。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 显示书签侧边栏
var bIsShow = true;  // true 显示，false 隐藏
var cmdId = 35021;  // 35021 书签侧边栏，35022 电子印章侧边栏，35065 批注侧边栏
plugInObj.ShowSidebar(bIsShow, cmdId);

// 显示电子印章侧边栏
plugInObj.ShowSidebar(true, 35022);

// 显示批注侧边栏
plugInObj.ShowSidebar(true, 35065);

// 隐藏侧边栏
plugInObj.ShowSidebar(false, 0); // 隐藏时cmdId无效

侧边栏管理示例：

javascript

// 侧边栏管理
function manageSidebar() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 侧边栏ID常量
    var SIDEBAR_IDS = {
        BOOKMARKS: 35021,    // 书签侧边栏
        SECURITY_SIGN: 35022, // 电子印章侧边栏
        ANNOTATIONS: 35065   // 批注侧边栏
    };
    
    // 显示指定侧边栏
    function showSidebar(sidebarId) {
        plugInObj.ShowSidebar(true, sidebarId);
        console.log("侧边栏已显示:", sidebarId);
    }
    
    // 隐藏指定侧边栏
    function hideSidebar(sidebarId) {
        plugInObj.ShowSidebar(false, sidebarId);
        console.log("侧边栏已隐藏:", sidebarId);
    }
    
    // 切换侧边栏显示状态
    function toggleSidebar(sidebarId) {
        // 这里需要根据当前状态判断，实际应用中可能需要维护状态
        plugInObj.ShowSidebar(true, sidebarId);
        console.log("侧边栏状态已切换:", sidebarId);
    }
    
    return {
        showSidebar: showSidebar,
        hideSidebar: hideSidebar,
        toggleSidebar: toggleSidebar,
        SIDEBAR_IDS: SIDEBAR_IDS
    };
}

// 使用侧边栏管理
var sidebarManager = manageSidebar();
sidebarManager.showSidebar(sidebarManager.SIDEBAR_IDS.BOOKMARKS);

SetViewMode

语法：

javascript

SetViewMode(viewMode)

功能：
设置PDF文档显示模式。

参数：

名称	必选/可选	数据类型	说明
viewMode	必选	long	文档显示模式值

返回值：
无返回值

说明：
设置PDF文档显示模式，1：适合页面，2：适合高度，3：适合宽度。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 按适合页面显示
plugInObj.SetViewMode(1);

// 按适合高度显示
plugInObj.SetViewMode(2);

// 按适合宽度显示
plugInObj.SetViewMode(3);

视图模式管理示例：

javascript

// 视图模式管理
function manageViewMode() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 视图模式常量
    var VIEW_MODES = {
        FIT_PAGE: 1,    // 适合页面
        FIT_HEIGHT: 2,  // 适合高度
        FIT_WIDTH: 3    // 适合宽度
    };
    
    // 设置视图模式
    function setViewMode(mode) {
        plugInObj.SetViewMode(mode);
        console.log("视图模式已设置:", mode);
    }
    
    // 适合页面显示
    function fitPage() {
        setViewMode(VIEW_MODES.FIT_PAGE);
    }
    
    // 适合高度显示
    function fitHeight() {
        setViewMode(VIEW_MODES.FIT_HEIGHT);
    }
    
    // 适合宽度显示
    function fitWidth() {
        setViewMode(VIEW_MODES.FIT_WIDTH);
    }
    
    return {
        setViewMode: setViewMode,
        fitPage: fitPage,
        fitHeight: fitHeight,
        fitWidth: fitWidth,
        VIEW_MODES: VIEW_MODES
    };
}

// 使用视图模式管理
var viewModeManager = manageViewMode();
viewModeManager.fitPage();

SetViewPercent

语法：

javascript

SetViewPercent(viewPercent)

功能：
设置PDF文档显示百分比方法。

参数：

名称	必选/可选	数据类型	说明
viewPercent	必选	long	文档显示百分比值

返回值：
无返回值

说明：
设置PDF文档显示百分比方法。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 按50%的比例显示
plugInObj.SetViewPercent(50);

// 按100%的比例显示
plugInObj.SetViewPercent(100);

// 按200%的比例显示
plugInObj.SetViewPercent(200);

视图百分比管理示例：

javascript

// 视图百分比管理
function manageViewPercent() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 常用百分比常量
    var VIEW_PERCENTS = {
        QUARTER: 25,    // 25%
        HALF: 50,       // 50%
        NORMAL: 100,    // 100%
        DOUBLE: 200,    // 200%
        TRIPLE: 300     // 300%
    };
    
    // 设置视图百分比
    function setViewPercent(percent) {
        plugInObj.SetViewPercent(percent);
        console.log("视图百分比已设置:", percent + "%");
    }
    
    // 放大视图
    function zoomIn() {
        var currentPercent = getCurrentViewPercent(); // 需要实现获取当前百分比的方法
        var newPercent = Math.min(currentPercent * 1.2, 500); // 最大500%
        setViewPercent(Math.round(newPercent));
    }
    
    // 缩小视图
    function zoomOut() {
        var currentPercent = getCurrentViewPercent(); // 需要实现获取当前百分比的方法
        var newPercent = Math.max(currentPercent / 1.2, 10); // 最小10%
        setViewPercent(Math.round(newPercent));
    }
    
    return {
        setViewPercent: setViewPercent,
        zoomIn: zoomIn,
        zoomOut: zoomOut,
        VIEW_PERCENTS: VIEW_PERCENTS
    };
}

// 使用视图百分比管理
var viewPercentManager = manageViewPercent();
viewPercentManager.setViewPercent(100);

内容添加方法

AddBarcodePicture

语法：

javascript

AddBarcodePicture(pageNo, [mode], [bgray], [percent], [bPrint], [bSelect], [posX], [posY], [cx], [cy], [printType])

功能：
给PDF添加公文二维码图片。

参数：

名称	必选/可选	数据类型	说明
pageNo	必选	long	指定页数，从第一页，0开始计算
mode	可选	long	水印模式
bgray	可选	bool	变灰，对于水印没必要支持
percent	可选	long	透明度百分比
bPrint	可选	bool	是否打印水印
bSelect	可选	bool	是否允许选择文件
posX	可选	long	左上角x坐标
posY	可选	long	左上角y坐标
cx	可选	long	水印宽度
cy	可选	long	水印高度
printType	可选	long	图片打印模式

返回值：
无返回值

说明：
参数mode取值0：原始图片(可使用posX,posY定位)，1：适合宽度，2：适合高度。参数bPrint对于单纯的水印来说本参数不起作用。参数posX、posY当参数mode值为0时有效。参数printType：该可选参数的值为{0|1|2}，默认为0；0：表示界面和打印都显示图片。1：表示界面不显示，打印显示。2：表示界面显示，打印不显示。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 添加公文二维码图片
plugInObj.AddBarcodePicture(1, 0, false, 0, true, true, 550, 1000, 150, 150, 0);

// 添加二维码到所有页面
plugInObj.AddBarcodePicture(-1, 1, false, 50, true, true, 0, 0, 200, 200, 0);

AddPicWaterMarkLocal

语法：

javascript

AddPicWaterMarkLocal(filepath, pageNo, [mode], [bgray], [percent], [bPrint], [bSelect], [posX], [posY], [cx], [cy], [printType])

功能：
从本地给PDF添加图片水印。

参数：

名称	必选/可选	数据类型	说明
filepath	必选	string	本地图片的路径
pageNo	必选	long	指定页码
mode	可选	long	水印模式
bgray	可选	bool	变灰，对于水印没必要支持
percent	可选	long	透明度百分比
bPrint	可选	bool	是否打印水印
bSelect	可选	bool	是否允许选择文件
posX	可选	long	左上角x坐标
posY	可选	long	左上角y坐标
cx	可选	long	水印宽度
cy	可选	long	水印高度
printType	可选	long	图片打印模式

返回值：
无返回值

说明：
参数pageNo代表页码，0代表第一页，传-1默认代表所有页。参数mode取值0：原始图片(可使用posX,posY定位)，1：适合宽度，2：适合高度。参数bPrint对于单纯的水印来说本参数不起作用。参数posX、posY当参数mode值为0时有效。参数printType：该可选参数的值为{0|1|2}，默认为0；0：表示界面和打印都显示图片。1：表示界面不显示，打印显示。2：表示界面显示，打印不显示。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 从本地添加图片水印
plugInObj.AddPicWaterMarkLocal("C:\\Users\\test.jpg", 1, 2, false, 50, true, false, 1);

// 添加水印到所有页面
plugInObj.AddPicWaterMarkLocal("C:\\Users\\watermark.png", -1, 1, false, 30, true, false, 0);

AddPicWaterMarkUrl

语法：

javascript

AddPicWaterMarkUrl(url, pageNo, [mode], [bgray], [percent], [bPrint], [bSelect], [posX], [posY], [cx], [cy], [printType])

功能：
从URL给PDF添加图片水印。

参数：

名称	必选/可选	数据类型	说明
url	必选	string	图片的URL地址
pageNo	必选	long	指定页码
mode	可选	long	水印模式
bgray	可选	bool	变灰，对于水印没必要支持
percent	可选	long	透明度百分比
bPrint	可选	bool	是否打印水印
bSelect	可选	bool	是否允许选择文件
posX	可选	long	左上角x坐标
posY	可选	long	左上角y坐标
cx	可选	long	水印宽度
cy	可选	long	水印高度
printType	可选	long	图片打印模式

返回值：
无返回值

说明：
参数pageNo代表页码，0代表第一页，传-1默认代表所有页。参数mode取值0：原始图片(可使用posX,posY定位)，1：适合高度，2：适合宽度，3：适合页面。参数bPrint对于单纯的水印来说本参数不起作用。参数posX、posY当参数mode值为0时有效。参数printType：该可选参数的值为{0|1|2}，默认为0；0：表示界面和打印都显示图片。1：表示界面不显示，打印显示。2：表示界面显示，打印不显示。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 从URL添加图片水印
plugInObj.AddPicWaterMarkUrl("http://example.com/watermark.png", 1, 2, false, 50, true, false, 0);

// 添加水印到所有页面
plugInObj.AddPicWaterMarkUrl("http://example.com/logo.png", -1, 1, false, 30, true, false, 0);

AddPicture

语法：

javascript

AddPicture(filepath, pageNo, [mode], [bgray], [percent], [bPrint], [bSelect], [posX], [posY], [cx], [cy], [printType])

功能：
从本地给PDF插入图片。

参数：

名称	必选/可选	数据类型	说明
filepath	必选	string	本地图片的路径
pageNo	必选	long	指定页码
mode	可选	long	图片模式
bgray	可选	bool	变灰，对于图片没必要支持
percent	可选	long	透明度百分比
bPrint	可选	bool	是否打印图片
bSelect	可选	bool	是否允许选择文件
posX	可选	long	左上角x坐标
posY	可选	long	左上角y坐标
cx	可选	long	图片宽度
cy	可选	long	图片高度
printType	可选	long	图片打印模式

返回值：
无返回值

说明：
参数pageNo代表页码，0代表第一页，传-1默认代表所有页。参数mode取值0：原始图片(可使用posX,posY定位)，1：适合宽度，2：适合高度。参数bPrint对于单纯的图片来说本参数不起作用。参数posX、posY当参数mode值为0时有效。参数printType：该可选参数的值为{0|1|2}，默认为0；0：表示界面和打印都显示图片。1：表示界面不显示，打印显示。2：表示界面显示，打印不显示。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 从本地插入图片
plugInObj.AddPicture("C:\\Users\\test.jpg", 1, 2, false, 50, true, false, 1);

// 插入图片到所有页面
plugInObj.AddPicture("C:\\Users\\logo.png", -1, 1, false, 30, true, false, 0);

注意： AddPicWaterMarkLocal与AddPicture的区别是：AddPicWaterMarkLocal插入的图片水印是衬于正文内容下方，如果正文有图片，或者PDF是扫描件，那么图片水印就会被遮挡；AddPicture插入的图片是浮于正文内容上方，不会受图片等其他对象遮挡。

AddTextWaterMark

语法：

javascript

AddTextWaterMark(text, pageNo, [mode], [bgray], [percent], [dpi], [bPrint], [posX], [posY], [cx], [cy], [printType])

功能：
给PDF添加文字水印。

参数：

名称	必选/可选	数据类型	说明
text	必选	string	要添加的文字
pageNo	必选	long	指定页码
mode	可选	long	水印模式
bgray	可选	bool	变灰，对于水印没必要支持
percent	可选	long	透明度百分比
dpi	可选	bool	分辨率
bPrint	可选	bool	是否打印水印
posX	可选	long	左上角x坐标
posY	可选	long	左上角y坐标
cx	可选	long	水印宽度
cy	可选	long	水印高度
printType	可选	long	图片打印模式

返回值：
无返回值

说明：
为文档添加文字水印。参数pageNo代表页码，0代表第一页，传-1默认代表所有页。参数mode取值0：原始图片(可使用posX,posY定位)，1：适合宽度，2：适合高度。参数bPrint对于单纯的水印来说本参数不起作用。参数posX、posY当参数mode值为0时有效。参数printType：该可选参数的值为{0|1|2}，默认为0；0：表示界面和打印都显示图片。1：表示界面不显示，打印显示。2：表示界面显示，打印不显示。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 添加文字水印
plugInObj.AddTextWaterMark("NTKO PDF", 0, 2, false, 50, 200, true, false, 1);

// 添加水印到所有页面
plugInObj.AddTextWaterMark("机密文档", -1, 1, false, 30, 200, true, false, 0);

AddText

语法：

javascript

AddText(text, pageNo, [mode], [bgray], [percent], [dpi], [bPrint], [posX], [posY], [cx], [cy], [printType])

功能：
给PDF添加文字。

参数：

名称	必选/可选	数据类型	说明
text	必选	string	要添加的文字
pageNo	必选	long	指定页码
mode	可选	long	文字模式
bgray	可选	bool	变灰，对于文字没必要支持
percent	可选	long	透明度百分比
dpi	可选	bool	分辨率
bPrint	可选	bool	是否打印文字
posX	可选	long	左上角x坐标
posY	可选	long	左上角y坐标
cx	可选	long	文字宽度
cy	可选	long	文字高度
printType	可选	long	图片打印模式

返回值：
无返回值

说明：
为文档添加文字。参数pageNo代表页码，0代表第一页，传-1默认代表所有页。参数mode取值0：原始图片(可使用posX,posY定位)，1：适合宽度，2：适合高度。参数bPrint对于单纯的文字来说本参数不起作用。参数posX、posY当参数mode值为0时有效。参数printType：该可选参数的值为{0|1|2}，默认为0；0：表示界面和打印都显示图片。1：表示界面不显示，打印显示。2：表示界面显示，打印不显示。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 添加文字
plugInObj.AddText("NTKO PDF", 0, 0, true, 0, 200, false, 400, 5, 300, 30, 1);

// 添加文字到所有页面
plugInObj.AddText("文档标题", -1, 1, false, 0, 200, true, 0, 0, 400, 50, 0);

注意： AddTextWaterMark与AddText的区别是：AddTextWaterMark添加的文字是衬于正文内容下方，如果正文有图片，或者PDF是扫描件，那么文字水印就会被遮挡；AddText添加的文字是浮于正文内容上方，不会受图片等其他对象遮挡。

SetAddTextFont

语法：

javascript

SetAddTextFont(fontName, clr)

功能：
设置添加的文字（水印）的字体名称与颜色。

参数：

名称	必选/可选	数据类型	说明
fontName	必选	string	字体名称
clr	必选	OLE_COLOR	颜色

返回值：
无返回值

说明：
在调用AddTextWaterMark或AddText方法之前设置，为两个方法所添加的文字内容设置字体名称和颜色。参数clr：其类型OLE_COLOR是一个BGR (Blue, Green, Red)数值。BGR value = (blue * 65536) + (green * 256) + red，如0xFF0000

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 设置字体和颜色
plugInObj.SetAddTextFont("微软雅黑", 255);

// 设置红色文字
plugInObj.SetAddTextFont("宋体", 0xFF0000);

// 设置蓝色文字
plugInObj.SetAddTextFont("黑体", 0x0000FF);

页面导航方法

GetCurPageStart

语法：

javascript

GetCurPageStart()

功能：
获取当前显示的页码。

返回值：
数值型

说明：
获取当前显示的页码。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 获取当前页码
var currentPage = plugInObj.GetCurPageStart();
console.log("当前页码:", currentPage);

GetPagesCount

语法：

javascript

GetPagesCount()

功能：
获取当前文档的总页数。

返回值：
数值型

说明：
获取当前文档的总页数。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 获取总页数
var pageCount = plugInObj.GetPagesCount();
console.log("文档总页数:", pageCount);

GotoPage

语法：

javascript

GotoPage(pageNo)

功能：
跳转到指定页。

参数：

名称	必选/可选	数据类型	说明
pageNo	必选	long	页码

返回值：
无返回值

说明：
跳转到指定页。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 跳转到第5页
plugInObj.GotoPage(5);

// 跳转到第一页
plugInObj.GotoPage(1);

// 跳转到最后一页
var pageCount = plugInObj.GetPagesCount();
plugInObj.GotoPage(pageCount);

文本查找方法

BeginFindNextText

语法：

javascript

BeginFindNextText(Filename, bMachCase)

功能：
查找下一处匹配的字符。

参数：

名称	必选/可选	数据类型	说明
Filename	必选	string	关键字
bMachCase	必选	bool	字母是否匹配大小写

返回值：
无返回值

说明：
查找下一处匹配的字符。参数bMachCase值为true代表匹配大小写，false代表不匹配。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 查找下一处匹配的字符（区分大小写）
plugInObj.BeginFindNextText("ntko", true);

// 查找下一处匹配的字符（不区分大小写）
plugInObj.BeginFindNextText("ntko", false);

BeginFindPrevText

语法：

javascript

BeginFindPrevText(Filename, bMachCase)

功能：
查找上一处匹配的字符。

参数：

名称	必选/可选	数据类型	说明
Filename	必选	string	关键字
bMachCase	必选	bool	字母是否匹配大小写

返回值：
无返回值

说明：
查找上一处匹配的字符。参数bMachCase值为true代表匹配大小写，false代表不匹配。

使用示例：

javascript

// 基本用法
var plugInObj = OfficeControlObj.ActiveDocument;

// 查找上一处匹配的字符（区分大小写）
plugInObj.BeginFindPrevText("ntko", true);

// 查找上一处匹配的字符（不区分大小写）
plugInObj.BeginFindPrevText("ntko", false);

方法分类总结

分类	方法	功能	说明
视图控制	`ShowSidebar`	控制侧边栏显示	显示/隐藏侧边栏
视图控制	`SetViewMode`	设置显示模式	适合页面/高度/宽度
视图控制	`SetViewPercent`	设置显示百分比	设置缩放比例
内容添加	`AddBarcodePicture`	添加二维码图片	添加公文二维码
内容添加	`AddPicWaterMarkLocal`	添加本地图片水印	从本地添加图片水印
内容添加	`AddPicWaterMarkUrl`	添加URL图片水印	从URL添加图片水印
内容添加	`AddPicture`	添加图片	从本地插入图片
内容添加	`AddTextWaterMark`	添加文字水印	添加文字水印
内容添加	`AddText`	添加文字	添加文字内容
内容添加	`SetAddTextFont`	设置文字字体	设置字体和颜色
页面导航	`GetCurPageStart`	获取当前页码	获取当前显示页码
页面导航	`GetPagesCount`	获取总页数	获取文档总页数
页面导航	`GotoPage`	跳转页面	跳转到指定页
文本查找	`BeginFindNextText`	查找下一处	查找下一处匹配字符
文本查找	`BeginFindPrevText`	查找上一处	查找上一处匹配字符

使用流程

1. 基本PDF插件方法控制流程

javascript

// 基本PDF插件方法控制流程
function basicPDFPluginMethodControl() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 设置基本视图
    function setBasicView() {
        // 设置显示模式
        plugInObj.SetViewMode(1); // 适合页面
        
        // 设置显示百分比
        plugInObj.SetViewPercent(100); // 100%
        
        // 显示书签侧边栏
        plugInObj.ShowSidebar(true, 35021);
        
        console.log("基本视图设置完成");
    }
    
    // 添加基本内容
    function addBasicContent() {
        // 添加文字水印
        plugInObj.AddTextWaterMark("机密文档", -1, 1, false, 30, 200, true, false, 0);
        
        // 添加文字
        plugInObj.AddText("文档标题", 0, 1, false, 0, 200, true, 0, 0, 400, 50, 0);
        
        console.log("基本内容添加完成");
    }
    
    return {
        setBasicView: setBasicView,
        addBasicContent: addBasicContent
    };
}

2. 高级PDF插件方法控制流程

javascript

// 高级PDF插件方法控制流程
function advancedPDFPluginMethodControl() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // PDF插件方法配置
    var pdfPluginMethodConfig = {
        enableSidebar: true,
        enableWatermark: true,
        enableText: true,
        enableSearch: true
    };
    
    // 应用PDF插件方法配置
    function applyPDFPluginMethodConfig() {
        try {
            // 设置视图
            if (pdfPluginMethodConfig.enableSidebar) {
                plugInObj.ShowSidebar(true, 35021);
            }
            
            // 添加水印
            if (pdfPluginMethodConfig.enableWatermark) {
                plugInObj.AddTextWaterMark("机密文档", -1, 1, false, 30, 200, true, false, 0);
            }
            
            // 添加文字
            if (pdfPluginMethodConfig.enableText) {
                plugInObj.AddText("文档标题", 0, 1, false, 0, 200, true, 0, 0, 400, 50, 0);
            }
            
            console.log("PDF插件方法配置应用成功");
        } catch (error) {
            console.error("PDF插件方法配置应用失败:", error);
        }
    }
    
    // 监控文档状态
    function monitorDocumentStatus() {
        var status = {
            currentPage: plugInObj.GetCurPageStart(),
            totalPages: plugInObj.GetPagesCount()
        };
        
        console.log("文档状态监控:", status);
        return status;
    }
    
    return {
        applyPDFPluginMethodConfig: applyPDFPluginMethodConfig,
        monitorDocumentStatus: monitorDocumentStatus
    };
}

3. PDF插件方法质量控制流程

javascript

// PDF插件方法质量控制流程
function pdfPluginMethodQualityControl() {
    // 处理PDF插件方法质量控制
    function controlPDFPluginMethodQuality() {
        var pdfPluginMethodQuality = {
            totalMethods: 0,
            successfulMethods: 0,
            failedMethods: 0,
            qualityScore: 0
        };
        
        // 计算质量分数
        if (pdfPluginMethodQuality.totalMethods > 0) {
            pdfPluginMethodQuality.qualityScore = (pdfPluginMethodQuality.successfulMethods / pdfPluginMethodQuality.totalMethods) * 100;
        }
        
        console.log("PDF插件方法质量控制:", pdfPluginMethodQuality);
        return pdfPluginMethodQuality;
    }
    
    // 执行质量控制
    var qualityResult = controlPDFPluginMethodQuality();
    console.log("PDF插件方法质量控制结果:", qualityResult);
}

完整示例

1. 基础PDF插件方法控制

javascript

// 基础PDF插件方法控制示例
function basicPDFPluginMethodControl() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // 设置基本视图
    function setBasicView() {
        // 设置显示模式
        plugInObj.SetViewMode(1);
        
        // 设置显示百分比
        plugInObj.SetViewPercent(100);
        
        console.log("基本视图设置完成");
    }
    
    // 添加基本内容
    function addBasicContent() {
        // 添加文字水印
        plugInObj.AddTextWaterMark("机密文档", -1, 1, false, 30, 200, true, false, 0);
        
        console.log("基本内容添加完成");
    }
    
    return {
        setBasicView: setBasicView,
        addBasicContent: addBasicContent
    };
}

2. 高级PDF插件方法控制

javascript

// 高级PDF插件方法控制示例
function advancedPDFPluginMethodControl() {
    var plugInObj = OfficeControlObj.ActiveDocument;
    
    // PDF插件方法管理
    var pdfPluginMethodManager = {
        isSidebarEnabled: true,
        isWatermarkEnabled: true,
        isTextEnabled: true
    };
    
    // 设置视图
    function setView() {
        if (pdfPluginMethodManager.isSidebarEnabled) {
            plugInObj.ShowSidebar(true, 35021);
        }
        
        plugInObj.SetViewMode(1);
        plugInObj.SetViewPercent(100);
    }
    
    // 添加内容
    function addContent() {
        if (pdfPluginMethodManager.isWatermarkEnabled) {
            plugInObj.AddTextWaterMark("机密文档", -1, 1, false, 30, 200, true, false, 0);
        }
        
        if (pdfPluginMethodManager.isTextEnabled) {
            plugInObj.AddText("文档标题", 0, 1, false, 0, 200, true, 0, 0, 400, 50, 0);
        }
    }
    
    return {
        setView: setView,
        addContent: addContent
    };
}

3. PDF插件方法质量控制

javascript

// PDF插件方法质量控制示例
function pdfPluginMethodQualityControl() {
    // PDF插件方法质量控制
    function controlPDFPluginMethodQuality() {
        var pdfPluginMethodQuality = {
            viewControl: 0,
            contentAdd: 0,
            pageNavigation: 0,
            textSearch: 0,
            errors: []
        };
        
        // 监控PDF插件方法质量
        function monitorPDFPluginMethodQuality(methodType, success) {
            if (success) {
                pdfPluginMethodQuality[methodType]++;
            } else {
                pdfPluginMethodQuality.errors.push({
                    method: methodType,
                    timestamp: new Date().toISOString()
                });
            }
        }
        
        console.log("PDF插件方法质量控制:", pdfPluginMethodQuality);
        return pdfPluginMethodQuality;
    }
    
    // 执行质量控制
    var qualityResult = controlPDFPluginMethodQuality();
    console.log("PDF插件方法质量控制结果:", qualityResult);
}

注意事项

方法调用顺序：注意PDF插件方法调用的顺序，确保在正确的时机执行相应操作
参数验证：验证PDF插件方法参数的有效性，避免空值或无效值
错误处理：实现完善的错误处理机制
性能考虑：避免频繁调用PDF插件方法
资源管理：及时清理不需要的资源
状态同步：保持PDF插件状态的一致性
用户体验：确保PDF插件方法调用不影响用户体验

错误处理

javascript

// PDF插件方法错误处理
function handlePDFPluginMethodError(methodType, error) {
    console.error("PDF插件方法处理失败:", methodType, error.message);
    
    switch(methodType) {
        case 'ShowSidebar':
            console.log("侧边栏控制失败，请检查:");
            console.log("1. 侧边栏ID是否正确");
            console.log("2. 侧边栏状态是否正确");
            console.log("3. 文档是否已加载");
            break;
        case 'SetViewMode':
            console.log("视图模式设置失败，请检查:");
            console.log("1. 视图模式值是否正确");
            console.log("2. 文档状态是否正常");
            console.log("3. 视图设置是否正确");
            break;
        case 'AddTextWaterMark':
            console.log("文字水印添加失败，请检查:");
            console.log("1. 文字内容是否有效");
            console.log("2. 页码是否正确");
            console.log("3. 水印参数是否正确");
            break;
        default:
            console.log("未知PDF插件方法处理失败");
    }
}

最佳实践

1. PDF插件方法管理最佳实践

javascript

// PDF插件方法管理最佳实践
function pdfPluginMethodManagementBestPractice() {
    // PDF插件方法配置
    var pdfPluginMethodConfig = {
        enableLogging: true,
        enableValidation: true,
        enableErrorHandling: true,
        enableQualityControl: true
    };
    
    // 应用PDF插件方法配置
    function applyPDFPluginMethodConfig() {
        try {
            // 设置PDF插件方法处理
            if (pdfPluginMethodConfig.enableLogging) {
                console.log("PDF插件方法日志已启用");
            }
            
            if (pdfPluginMethodConfig.enableValidation) {
                console.log("方法验证已启用");
            }
            
            console.log("PDF插件方法配置应用成功");
        } catch (error) {
            handlePDFPluginMethodError('applyPDFPluginMethodConfig', error);
        }
    }
    
    // 应用配置
    applyPDFPluginMethodConfig();
}

2. PDF插件方法质量控制最佳实践

javascript

// PDF插件方法质量控制最佳实践
function pdfPluginMethodQualityControlBestPractice() {
    // PDF插件方法质量控制
    function controlPDFPluginMethodQuality() {
        try {
            // PDF插件方法质量控制
            var pdfPluginMethodQuality = {
                totalMethods: 0,
                successfulMethods: 0,
                failedMethods: 0,
                qualityScore: 0
            };
            
            // 计算质量分数
            if (pdfPluginMethodQuality.totalMethods > 0) {
                pdfPluginMethodQuality.qualityScore = (pdfPluginMethodQuality.successfulMethods / pdfPluginMethodQuality.totalMethods) * 100;
            }
            
            console.log("PDF插件方法质量控制完成:", pdfPluginMethodQuality);
            return pdfPluginMethodQuality;
        } catch (error) {
            console.error("PDF插件方法质量控制失败:", error.message);
            return null;
        }
    }
    
    // 执行质量控制
    var qualityResult = controlPDFPluginMethodQuality();
    console.log("PDF插件方法质量控制结果:", qualityResult);
}

技术要点

方法调用顺序：注意PDF插件方法调用的顺序，确保在正确的时机执行相应操作
参数验证：验证PDF插件方法参数的有效性，避免空值或无效值
错误处理：完善的错误处理机制
性能优化：避免频繁调用PDF插件方法
资源管理：及时清理不需要的资源
状态同步：保持PDF插件状态的一致性
用户体验：确保PDF插件方法调用不影响用户体验

PDF插件主要方法参考 ​

概述 ​

视图控制方法 ​

ShowSidebar ​

SetViewMode ​

SetViewPercent ​

内容添加方法 ​

AddBarcodePicture ​

AddPicWaterMarkLocal ​

AddPicWaterMarkUrl ​

AddPicture ​

AddTextWaterMark ​

AddText ​

SetAddTextFont ​

页面导航方法 ​

GetCurPageStart ​

GetPagesCount ​

GotoPage ​

文本查找方法 ​

BeginFindNextText ​

BeginFindPrevText ​

方法分类总结 ​

使用流程 ​

1. 基本PDF插件方法控制流程 ​

2. 高级PDF插件方法控制流程 ​

3. PDF插件方法质量控制流程 ​

完整示例 ​

1. 基础PDF插件方法控制 ​

2. 高级PDF插件方法控制 ​

3. PDF插件方法质量控制 ​

注意事项 ​

错误处理 ​

最佳实践 ​

1. PDF插件方法管理最佳实践 ​

2. PDF插件方法质量控制最佳实践 ​

技术要点 ​

PDF插件主要方法参考

概述

视图控制方法

ShowSidebar

SetViewMode

SetViewPercent

内容添加方法

AddBarcodePicture

AddPicWaterMarkLocal

AddPicWaterMarkUrl

AddPicture

AddTextWaterMark

AddText

SetAddTextFont

页面导航方法

GetCurPageStart

GetPagesCount

GotoPage

文本查找方法

BeginFindNextText

BeginFindPrevText

方法分类总结

使用流程

1. 基本PDF插件方法控制流程

2. 高级PDF插件方法控制流程

3. PDF插件方法质量控制流程

完整示例

1. 基础PDF插件方法控制

2. 高级PDF插件方法控制

3. PDF插件方法质量控制

注意事项

错误处理

最佳实践

1. PDF插件方法管理最佳实践

2. PDF插件方法质量控制最佳实践

技术要点