文档信息和行为控制相关属性

概述

本节介绍软航OFFICE文档控件国产化版本文档信息和行为控制相关属性，这些属性允许开发者获取文档信息、控制文档行为、管理文档状态，为文档管理系统提供完整的文档控制能力。

文档对象属性

ActiveDocument

说明：
只读；返回文档对象的自动化接口。

语法：

javascript

// 读取
varObj = Obj.ActiveDocument;

说明：
比如：如果打开一个Word文档，则ActiveDocument代表一个Word.Document对象。可以用Javascript或者VBScript对该对象进行控制来操作Word文档。

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 获取文档对象
var activeDoc = obj.ActiveDocument;
console.log("文档对象:", activeDoc);

// 使用文档对象操作Word文档
if (activeDoc) {
    // 向当前文档插入文字
    activeDoc.Application.Selection.TypeText("这是插入的文字");
    console.log("文字已插入到文档");
    
    // 获取文档内容
    var content = activeDoc.Application.Selection.Text;
    console.log("当前选中内容:", content);
    
    // 设置文档格式
    activeDoc.Application.Selection.Font.Name = "宋体";
    activeDoc.Application.Selection.Font.Size = 12;
    console.log("文档格式已设置");
}

文档信息属性

WebFileName

说明：
String型字符串；可读写；当点击文档控件保存按钮时，要保存的Word文件的默认文件名。当文档控件从URL打开一个文档，并点击保存或者另存保存到本地时，默认出现在文件选择框中的文件名。

语法：

javascript

// 设置
Obj.WebFileName = varObj;

// 读取
varObj = Obj.WebFileName;

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 设置默认文件名
obj.WebFileName = "我的文档.docx";
console.log("默认文件名已设置");

// 读取默认文件名
var fileName = obj.WebFileName;
console.log("默认文件名:", fileName);

// 动态设置文件名
var currentDate = new Date();
var dateStr = currentDate.getFullYear() + "-" + 
              (currentDate.getMonth() + 1) + "-" + 
              currentDate.getDate();
obj.WebFileName = "文档_" + dateStr + ".docx";
console.log("动态文件名已设置:", obj.WebFileName);

DocType

说明：
数值型；只读；返回当前控件中的文档类型。

语法：

javascript

// 读取
varObj = Obj.DocType;

返回值及代表类型如下表：

值	类型	说明
0	没有文档	当前没有打开文档
1	Word	Word文档
6	WPS Doc	WPS文档
100	其他文档类型	其他类型的文档

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 获取文档类型
var docType = obj.DocType;
console.log("文档类型:", docType);

// 根据文档类型执行不同操作
switch(docType) {
    case 0:
        console.log("没有打开文档");
        break;
    case 1:
        console.log("Word文档");
        // 执行Word文档相关操作
        break;
    case 6:
        console.log("WPS文档");
        // 执行WPS文档相关操作
        break;
    case 100:
        console.log("其他文档类型");
        // 执行其他文档类型相关操作
        break;
    default:
        console.log("未知文档类型");
}

DocSize

说明：
数值型；只读；获取当前文档的字节数。

语法：

javascript

// 读取
varObj = Obj.DocSize;

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 获取文档大小
var docSize = obj.DocSize;
console.log("文档大小:", docSize, "字节");

// 格式化文档大小显示
function formatFileSize(bytes) {
    if (bytes === 0) return '0 Bytes';
    var k = 1024;
    var sizes = ['Bytes', 'KB', 'MB', 'GB'];
    var i = Math.floor(Math.log(bytes) / Math.log(k));
    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
}

var formattedSize = formatFileSize(docSize);
console.log("格式化文档大小:", formattedSize);

文档行为控制属性

IsNoCopy

说明：
布尔型；可读写；控件中的文档是否禁止拷贝；缺省值：FALSE。IsNoCopy属性只是禁用的WPS自身的剪贴板，因此可能达不到。

语法：

javascript

// 设置
Obj.IsNoCopy = {true|false};

// 读取
varObj = Obj.IsNoCopy;

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 禁止拷贝
obj.IsNoCopy = true;
console.log("文档拷贝已禁止");

// 允许拷贝
obj.IsNoCopy = false;
console.log("文档拷贝已允许");

// 读取拷贝状态
var isNoCopy = obj.IsNoCopy;
console.log("拷贝禁止状态:", isNoCopy);

IsStrictNoCopy

说明：
布尔型；可读写；是否严格禁止拷贝；缺省值：FALSE。IsStrictNoCopy可以用来设置严格的禁止拷贝控件中的内容。

语法：

javascript

// 设置
Obj.IsStrictNoCopy = {true|false};

// 读取
varObj = Obj.IsStrictNoCopy;

注意： Linux版文档控件中，IsNoCopy和IsStrictNoCopy所达到的禁止拷贝的效果相同，只能禁用WPS自身的剪切板。

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 严格禁止拷贝
obj.IsStrictNoCopy = true;
console.log("文档严格禁止拷贝已启用");

// 取消严格禁止拷贝
obj.IsStrictNoCopy = false;
console.log("文档严格禁止拷贝已取消");

// 读取严格禁止拷贝状态
var isStrictNoCopy = obj.IsStrictNoCopy;
console.log("严格禁止拷贝状态:", isStrictNoCopy);

StatusMessage

说明：
String型字符串；只读；返回最后操作的结果字符串。

语法：

javascript

// 读取
varObj = Obj.StatusMessage;

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 获取状态消息
var statusMessage = obj.StatusMessage;
console.log("状态消息:", statusMessage);

// 检查操作是否成功
if (statusMessage && statusMessage.trim() !== "") {
    console.log("最后操作结果:", statusMessage);
} else {
    console.log("没有状态消息");
}

// 监控状态消息变化
function monitorStatusMessage() {
    var currentMessage = obj.StatusMessage;
    if (currentMessage !== lastStatusMessage) {
        console.log("状态消息已更新:", currentMessage);
        lastStatusMessage = currentMessage;
    }
}

WebUserName

说明：
String型字符串；可读写；设定WebUserName属性，可以让控件在激活时，自动将word用户名设定为此属性的值。这个属性主要用于痕迹保留的用户名。此属性仅当打开Word、WPS文档才有效。

语法：

javascript

// 设置
Obj.WebUserName = "用户名";

// 读取
varObj = Obj.WebUserName;

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 设置用户名
obj.WebUserName = "张三";
console.log("用户名已设置为: 张三");

// 读取用户名
var userName = obj.WebUserName;
console.log("当前用户名:", userName);

// 动态设置用户名
var currentUser = getCurrentUser(); // 假设这是获取当前用户的方法
obj.WebUserName = currentUser;
console.log("动态用户名已设置:", obj.WebUserName);

LocalTempFileName

说明：
String型字符串；只读；返回临时文件的全路径。

语法：

javascript

// 读取
varObj = Obj.LocalTempFileName;

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 获取临时文件路径
var tempFileName = obj.LocalTempFileName;
console.log("临时文件路径:", tempFileName);

// 检查临时文件是否存在
if (tempFileName && tempFileName.trim() !== "") {
    console.log("临时文件路径有效:", tempFileName);
    
    // 可以用于文件操作
    console.log("临时文件目录:", tempFileName.substring(0, tempFileName.lastIndexOf('\\')));
} else {
    console.log("没有临时文件");
}

文档状态属性

IsOpenURLReadOnly

说明：
布尔型；只读；标识在使用OpenFromURL函数打开文档时是否传递了只读参数。在Linux版控件中，此只读禁止修改文档内容，且文档内容不能保存回服务器。因为保存回服务器的时候不会报错，因此，需要先判断此属性再执行保存回服务器的方法。

语法：

javascript

// 读取
varObj = Obj.IsOpenURLReadOnly;

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 检查文档是否只读
var isReadOnly = obj.IsOpenURLReadOnly;
console.log("文档只读状态:", isReadOnly);

// 根据只读状态执行不同操作
if (isReadOnly) {
    console.log("文档为只读模式，不能修改内容");
    // 禁用编辑功能
    disableEditFunctions();
} else {
    console.log("文档可编辑");
    // 启用编辑功能
    enableEditFunctions();
}

// 保存前检查只读状态
function saveDocument() {
    if (obj.IsOpenURLReadOnly) {
        console.log("文档为只读，不能保存到服务器");
        return false;
    } else {
        console.log("可以保存到服务器");
        return true;
    }
}

IsOpenFromUrl

说明：
布尔型；只读；判断文档是否是从URL打开。

语法：

javascript

// 读取
varObj = Obj.IsOpenFromUrl;

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 检查文档是否从URL打开
var isFromUrl = obj.IsOpenFromUrl;
console.log("文档是否从URL打开:", isFromUrl);

// 根据打开方式执行不同操作
if (isFromUrl) {
    console.log("文档从URL打开");
    // 执行URL文档相关操作
    handleUrlDocument();
} else {
    console.log("文档从本地打开");
    // 执行本地文档相关操作
    handleLocalDocument();
}

IsShowFullScreenButton

说明：
布尔型；可读写；可以设定控件是否显示全屏按钮以及全屏后的返回按钮。即使不显示，用户也可以双击控件标题栏来进入/退出全屏模式。

语法：

javascript

// 设置
Obj.IsShowFullScreenButton = {true|false};

// 读取
varObj = Obj.IsShowFullScreenButton;

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 显示全屏按钮
obj.IsShowFullScreenButton = true;
console.log("全屏按钮已显示");

// 隐藏全屏按钮
obj.IsShowFullScreenButton = false;
console.log("全屏按钮已隐藏");

// 读取全屏按钮状态
var isShowFullScreenButton = obj.IsShowFullScreenButton;
console.log("全屏按钮显示状态:", isShowFullScreenButton);

CancelLastCommand

说明：
布尔型；只写；在"OnFileCommand"事件中使用。请参考"OnFileCommand"事件。设置最后一次的文件操作是否应该取消。该属性可用于接管缺省的工具栏的新建，打开或者保存操作，并设置该参数为true来取消缺省操作。

语法：

javascript

// 设置
Obj.CancelLastCommand = {true|false};

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 取消最后命令
obj.CancelLastCommand = true;
console.log("最后命令已取消");

// 允许最后命令
obj.CancelLastCommand = false;
console.log("最后命令已允许");

// 在OnFileCommand事件中使用
<script type="text/javascript" language="javascript" for="TANGER_OCX" event="OnFileCommand(TANGER_OCX_str,TANGER_OCX_obj);">
    // 检查命令类型
    if (TANGER_OCX_str === "FileNew") {
        // 自定义新建操作
        customNewDocument();
        // 取消默认操作
        TANGER_OCX_obj.CancelLastCommand = true;
    }
</script>

Linux特有属性

bIsEnabledSaveLog

说明：
布尔型；可读写；用来设置保存文件到服务器时，是否启用日志。

语法：

javascript

// 设置
Obj.bIsEnabledSaveLog = {true|false};

// 读取
varObj = Obj.bIsEnabledSaveLog;

注意： 此属性为Linux文档控件特有属性，暂不与Windows版文档控件通用。

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 启用保存日志
obj.bIsEnabledSaveLog = true;
console.log("保存日志已启用");

// 禁用保存日志
obj.bIsEnabledSaveLog = false;
console.log("保存日志已禁用");

// 读取保存日志状态
var isEnabledSaveLog = obj.bIsEnabledSaveLog;
console.log("保存日志状态:", isEnabledSaveLog);

IsGenDiffFileFieldName

说明：
布尔型；可读写；用来设置控件提交文档时是否产生不同的域值。

语法：

javascript

// 设置
Obj.IsGenDiffFileFieldName = {true|false};

// 读取
varObj = Obj.IsGenDiffFileFieldName;

注意： 此属性为Linux文档控件特有属性，暂不与Windows版文档控件通用。

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 启用不同域值生成
obj.IsGenDiffFileFieldName = true;
console.log("不同域值生成已启用");

// 禁用不同域值生成
obj.IsGenDiffFileFieldName = false;
console.log("不同域值生成已禁用");

// 读取不同域值生成状态
var isGenDiffFileFieldName = obj.IsGenDiffFileFieldName;
console.log("不同域值生成状态:", isGenDiffFileFieldName);

bIsOpenFromMem

说明：
布尔型；可读写；用来设置控件打开服务器文档时是否产生本地缓存文件。通常与openfromurl方法配套使用。

语法：

javascript

// 设置
Obj.bIsOpenFromMem = {true|false};

// 读取
varObj = Obj.bIsOpenFromMem;

注意： 此属性为Linux文档控件特有属性，暂不与Windows版文档控件通用。

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 启用内存打开
obj.bIsOpenFromMem = true;
console.log("内存打开已启用");

// 禁用内存打开
obj.bIsOpenFromMem = false;
console.log("内存打开已禁用");

// 读取内存打开状态
var isOpenFromMem = obj.bIsOpenFromMem;
console.log("内存打开状态:", isOpenFromMem);

bIsSaveFromMem

说明：
布尔型；可读写；用来设置控件提交文档到服务器时是否产生本地缓存文件。通常与savetourl方法配套使用。

语法：

javascript

// 设置
Obj.bIsSaveFromMem = {true|false};

// 读取
varObj = Obj.bIsSaveFromMem;

注意： 此属性为Linux文档控件特有属性，暂不与Windows版文档控件通用。

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 启用内存保存
obj.bIsSaveFromMem = true;
console.log("内存保存已启用");

// 禁用内存保存
obj.bIsSaveFromMem = false;
console.log("内存保存已禁用");

// 读取内存保存状态
var isSaveFromMem = obj.bIsSaveFromMem;
console.log("内存保存状态:", isSaveFromMem);

IsShowQATMenu

说明：
布尔型；可读写；用来设置是否显示wps快捷工具栏菜单。

语法：

javascript

// 设置
Obj.IsShowQATMenu = {true|false};

// 读取
varObj = Obj.IsShowQATMenu;

注意： 此属性为Linux文档控件特有属性，暂不与Windows版文档控件通用。并且设置该属性时需要先将WPS设置为robbion风格。

使用示例：

javascript

// 基本用法
var obj = OfficeControlObj;

// 显示快捷工具栏菜单
obj.IsShowQATMenu = true;
console.log("快捷工具栏菜单已显示");

// 隐藏快捷工具栏菜单
obj.IsShowQATMenu = false;
console.log("快捷工具栏菜单已隐藏");

// 读取快捷工具栏菜单状态
var isShowQATMenu = obj.IsShowQATMenu;
console.log("快捷工具栏菜单显示状态:", isShowQATMenu);

属性分类总结

分类	属性	类型	功能	说明
文档对象	`ActiveDocument`	只读	文档对象	返回文档对象的自动化接口
文档信息	`WebFileName`	可读写	默认文件名	保存时的默认文件名
文档信息	`DocType`	只读	文档类型	当前控件中的文档类型
文档信息	`DocSize`	只读	文档大小	当前文档的字节数
行为控制	`IsNoCopy`	可读写	禁止拷贝	控件中的文档是否禁止拷贝
行为控制	`IsStrictNoCopy`	可读写	严格禁止拷贝	是否严格禁止拷贝
行为控制	`StatusMessage`	只读	状态消息	返回最后操作的结果字符串
行为控制	`WebUserName`	可读写	用户名	设定Word用户名
行为控制	`LocalTempFileName`	只读	临时文件路径	返回临时文件的全路径
文档状态	`IsOpenURLReadOnly`	只读	只读状态	文档是否只读
文档状态	`IsOpenFromUrl`	只读	URL打开状态	文档是否从URL打开
文档状态	`IsShowFullScreenButton`	可读写	全屏按钮	是否显示全屏按钮
文档状态	`CancelLastCommand`	只写	取消命令	取消最后一次的文件操作
Linux特有	`bIsEnabledSaveLog`	可读写	保存日志	保存文件到服务器时是否启用日志
Linux特有	`IsGenDiffFileFieldName`	可读写	不同域值	提交文档时是否产生不同的域值
Linux特有	`bIsOpenFromMem`	可读写	内存打开	打开服务器文档时是否产生本地缓存文件
Linux特有	`bIsSaveFromMem`	可读写	内存保存	提交文档到服务器时是否产生本地缓存文件
Linux特有	`IsShowQATMenu`	可读写	快捷工具栏菜单	是否显示wps快捷工具栏菜单

使用流程

1. 基本文档信息管理流程

javascript

// 基本文档信息管理流程
function basicDocumentInfoManagement() {
    var obj = OfficeControlObj;
    
    // 获取文档信息
    function getDocumentInfo() {
        var docType = obj.DocType;
        var docSize = obj.DocSize;
        var webFileName = obj.WebFileName;
        var webUserName = obj.WebUserName;
        
        console.log("文档信息:");
        console.log("文档类型:", docType);
        console.log("文档大小:", docSize);
        console.log("默认文件名:", webFileName);
        console.log("用户名:", webUserName);
        
        return {
            docType: docType,
            docSize: docSize,
            webFileName: webFileName,
            webUserName: webUserName
        };
    }
    
    // 设置文档行为
    function setDocumentBehavior() {
        obj.IsNoCopy = true;
        obj.IsStrictNoCopy = true;
        obj.IsShowFullScreenButton = true;
        console.log("文档行为设置完成");
    }
    
    return {
        getDocumentInfo: getDocumentInfo,
        setDocumentBehavior: setDocumentBehavior
    };
}

2. 高级文档信息管理流程

javascript

// 高级文档信息管理流程
function advancedDocumentInfoManagement() {
    var obj = OfficeControlObj;
    
    // 文档信息管理配置
    var documentConfig = {
        enableLogging: true,
        enableValidation: true,
        enableErrorHandling: true,
        enableQualityControl: true
    };
    
    // 应用文档信息管理配置
    function applyDocumentConfig() {
        try {
            if (documentConfig.enableLogging) {
                console.log("文档信息管理日志已启用");
            }
            
            if (documentConfig.enableValidation) {
                console.log("文档信息验证已启用");
            }
            
            console.log("文档信息管理配置应用成功");
        } catch (error) {
            console.error("文档信息管理配置应用失败:", error);
        }
    }
    
    // 监控文档状态
    function monitorDocumentStatus() {
        var status = {
            docType: obj.DocType,
            docSize: obj.DocSize,
            isReadOnly: obj.IsOpenURLReadOnly,
            isFromUrl: obj.IsOpenFromUrl,
            statusMessage: obj.StatusMessage
        };
        
        console.log("文档状态监控:", status);
        return status;
    }
    
    return {
        applyDocumentConfig: applyDocumentConfig,
        monitorDocumentStatus: monitorDocumentStatus
    };
}

3. 文档信息质量控制流程

javascript

// 文档信息质量控制流程
function documentInfoQualityControl() {
    var obj = OfficeControlObj;
    
    // 文档信息质量控制
    function controlDocumentInfoQuality() {
        var documentQuality = {
            totalProperties: 0,
            validProperties: 0,
            invalidProperties: 0,
            qualityScore: 0
        };
        
        // 检查文档信息属性
        var documentProperties = [
            { name: 'DocType', value: obj.DocType },
            { name: 'DocSize', value: obj.DocSize },
            { name: 'WebFileName', value: obj.WebFileName },
            { name: 'WebUserName', value: obj.WebUserName }
        ];
        
        documentQuality.totalProperties = documentProperties.length;
        
        for (var i = 0; i < documentProperties.length; i++) {
            if (documentProperties[i].value !== null && documentProperties[i].value !== undefined) {
                documentQuality.validProperties++;
            } else {
                documentQuality.invalidProperties++;
            }
        }
        
        if (documentQuality.totalProperties > 0) {
            documentQuality.qualityScore = (documentQuality.validProperties / documentQuality.totalProperties) * 100;
        }
        
        console.log("文档信息质量控制:", documentQuality);
        return documentQuality;
    }
    
    // 执行质量控制
    var qualityResult = controlDocumentInfoQuality();
    console.log("文档信息质量控制结果:", qualityResult);
}

完整示例

1. 基础文档信息管理

javascript

// 基础文档信息管理示例
function basicDocumentInfoManagement() {
    var obj = OfficeControlObj;
    
    // 获取文档信息
    function getDocumentInfo() {
        var docType = obj.DocType;
        var docSize = obj.DocSize;
        var webFileName = obj.WebFileName;
        var webUserName = obj.WebUserName;
        
        console.log("文档信息:");
        console.log("文档类型:", docType);
        console.log("文档大小:", docSize);
        console.log("默认文件名:", webFileName);
        console.log("用户名:", webUserName);
        
        return {
            docType: docType,
            docSize: docSize,
            webFileName: webFileName,
            webUserName: webUserName
        };
    }
    
    // 设置文档行为
    function setDocumentBehavior() {
        obj.IsNoCopy = true;
        obj.IsStrictNoCopy = true;
        obj.IsShowFullScreenButton = true;
        console.log("文档行为设置完成");
    }
    
    return {
        getDocumentInfo: getDocumentInfo,
        setDocumentBehavior: setDocumentBehavior
    };
}

2. 高级文档信息管理

javascript

// 高级文档信息管理示例
function advancedDocumentInfoManagement() {
    var obj = OfficeControlObj;
    
    // 文档信息管理配置
    var documentConfig = {
        enableLogging: true,
        enableValidation: true,
        enableErrorHandling: true,
        enableQualityControl: true
    };
    
    // 应用文档信息管理配置
    function applyDocumentConfig() {
        if (documentConfig.enableLogging) {
            console.log("文档信息管理日志已启用");
        }
        
        if (documentConfig.enableValidation) {
            console.log("文档信息验证已启用");
        }
        
        console.log("文档信息管理配置应用完成");
    }
    
    // 监控文档状态
    function monitorDocumentStatus() {
        var status = {
            docType: obj.DocType,
            docSize: obj.DocSize,
            isReadOnly: obj.IsOpenURLReadOnly,
            isFromUrl: obj.IsOpenFromUrl,
            statusMessage: obj.StatusMessage
        };
        
        console.log("文档状态:", status);
        return status;
    }
    
    return {
        applyDocumentConfig: applyDocumentConfig,
        monitorDocumentStatus: monitorDocumentStatus
    };
}

3. 文档信息质量控制

javascript

// 文档信息质量控制示例
function documentInfoQualityControl() {
    var obj = OfficeControlObj;
    
    // 文档信息质量控制
    function controlDocumentInfoQuality() {
        var documentQuality = {
            totalProperties: 0,
            validProperties: 0,
            invalidProperties: 0,
            qualityScore: 0
        };
        
        // 检查文档信息属性
        var documentProperties = [
            { name: 'DocType', value: obj.DocType },
            { name: 'DocSize', value: obj.DocSize },
            { name: 'WebFileName', value: obj.WebFileName },
            { name: 'WebUserName', value: obj.WebUserName }
        ];
        
        documentQuality.totalProperties = documentProperties.length;
        
        for (var i = 0; i < documentProperties.length; i++) {
            if (documentProperties[i].value !== null && documentProperties[i].value !== undefined) {
                documentQuality.validProperties++;
            } else {
                documentQuality.invalidProperties++;
            }
        }
        
        if (documentQuality.totalProperties > 0) {
            documentQuality.qualityScore = (documentQuality.validProperties / documentQuality.totalProperties) * 100;
        }
        
        console.log("文档信息质量控制:", documentQuality);
        return documentQuality;
    }
    
    // 执行质量控制
    var qualityResult = controlDocumentInfoQuality();
    console.log("文档信息质量控制结果:", qualityResult);
}

注意事项

属性访问：确保在访问文档属性前，文档控件已正确加载
属性验证：验证文档属性值的有效性，避免设置无效值
错误处理：实现完善的错误处理机制
性能考虑：避免频繁访问文档属性
资源管理：及时清理不需要的资源
状态同步：保持文档状态的一致性
用户体验：确保文档设置不影响用户体验

错误处理

javascript

// 文档信息属性错误处理
function handleDocumentPropertyError(propertyType, error) {
    console.error("文档信息属性处理失败:", propertyType, error.message);
    
    switch(propertyType) {
        case 'ActiveDocument':
            console.log("文档对象获取失败，请检查:");
            console.log("1. 文档控件是否已加载");
            console.log("2. 文档是否已打开");
            console.log("3. 文档类型是否支持");
            break;
        case 'DocType':
            console.log("文档类型获取失败，请检查:");
            console.log("1. 文档控件是否已加载");
            console.log("2. 文档是否已打开");
            console.log("3. 文档类型是否有效");
            break;
        case 'DocSize':
            console.log("文档大小获取失败，请检查:");
            console.log("1. 文档控件是否已加载");
            console.log("2. 文档是否已打开");
            console.log("3. 文档大小是否有效");
            break;
        default:
            console.log("未知文档信息属性处理失败");
    }
}

最佳实践

1. 文档信息管理最佳实践

javascript

// 文档信息管理最佳实践
function documentInfoManagementBestPractice() {
    // 文档信息管理配置
    var documentConfig = {
        enableLogging: true,
        enableValidation: true,
        enableErrorHandling: true,
        enableQualityControl: true
    };
    
    // 应用文档信息管理配置
    function applyDocumentConfig() {
        try {
            // 设置文档信息管理处理
            if (documentConfig.enableLogging) {
                console.log("文档信息管理日志已启用");
            }
            
            if (documentConfig.enableValidation) {
                console.log("文档信息验证已启用");
            }
            
            console.log("文档信息管理配置应用成功");
        } catch (error) {
            handleDocumentPropertyError('applyDocumentConfig', error);
        }
    }
    
    // 应用配置
    applyDocumentConfig();
}

2. 文档信息质量控制最佳实践

javascript

// 文档信息质量控制最佳实践
function documentInfoQualityControlBestPractice() {
    // 文档信息质量控制
    function controlDocumentInfoQuality() {
        try {
            // 文档信息质量控制
            var documentQuality = {
                totalProperties: 0,
                validProperties: 0,
                invalidProperties: 0,
                qualityScore: 0
            };
            
            // 计算质量分数
            if (documentQuality.totalProperties > 0) {
                documentQuality.qualityScore = (documentQuality.validProperties / documentQuality.totalProperties) * 100;
            }
            
            console.log("文档信息质量控制完成:", documentQuality);
            return documentQuality;
        } catch (error) {
            console.error("文档信息质量控制失败:", error.message);
            return null;
        }
    }
    
    // 执行质量控制
    var qualityResult = controlDocumentInfoQuality();
    console.log("文档信息质量控制结果:", qualityResult);
}

技术要点

属性访问：确保在访问文档属性前，文档控件已正确加载
属性验证：验证文档属性值的有效性，避免设置无效值
错误处理：完善的错误处理机制
性能优化：避免频繁访问文档属性
资源管理：及时清理不需要的资源
状态同步：保持文档状态的一致性
用户体验：确保文档设置不影响用户体验

文档信息和行为控制相关属性 ​

概述 ​

文档对象属性 ​

ActiveDocument ​

文档信息属性 ​

WebFileName ​

DocType ​

DocSize ​

文档行为控制属性 ​

IsNoCopy ​

IsStrictNoCopy ​

StatusMessage ​

WebUserName ​

LocalTempFileName ​

文档状态属性 ​

IsOpenURLReadOnly ​

IsOpenFromUrl ​

IsShowFullScreenButton ​

CancelLastCommand ​

Linux特有属性 ​

bIsEnabledSaveLog ​

IsGenDiffFileFieldName ​

bIsOpenFromMem ​

bIsSaveFromMem ​

IsShowQATMenu ​

属性分类总结 ​

使用流程 ​

1. 基本文档信息管理流程 ​

2. 高级文档信息管理流程 ​

3. 文档信息质量控制流程 ​

完整示例 ​

1. 基础文档信息管理 ​

2. 高级文档信息管理 ​

3. 文档信息质量控制 ​

注意事项 ​

错误处理 ​

最佳实践 ​

1. 文档信息管理最佳实践 ​

2. 文档信息质量控制最佳实践 ​

技术要点 ​

文档信息和行为控制相关属性

概述

文档对象属性

ActiveDocument

文档信息属性

WebFileName

DocType

DocSize

文档行为控制属性

IsNoCopy

IsStrictNoCopy

StatusMessage

WebUserName

LocalTempFileName

文档状态属性

IsOpenURLReadOnly

IsOpenFromUrl

IsShowFullScreenButton

CancelLastCommand

Linux特有属性

bIsEnabledSaveLog

IsGenDiffFileFieldName

bIsOpenFromMem

bIsSaveFromMem

IsShowQATMenu

属性分类总结

使用流程

1. 基本文档信息管理流程

2. 高级文档信息管理流程

3. 文档信息质量控制流程

完整示例

1. 基础文档信息管理

2. 高级文档信息管理

3. 文档信息质量控制

注意事项

错误处理

最佳实践

1. 文档信息管理最佳实践

2. 文档信息质量控制最佳实践

技术要点