EXCEL相关事件

概述

本节介绍软航OFFICE文档控件提供的EXCEL相关事件，这些事件允许开发者在用户与EXCEL文档交互时进行响应和处理，为文档管理系统提供完整的EXCEL事件处理能力。

选择变化事件

OnSheetSelectionChange

语法：

javascript

OnSheetSelectionChange(SheetName, row, col)

功能：
该事件在EXCEL所选区域改变时发生。

参数：

名称	必选/可选	数据类型	说明
SheetName	必选	string	工作表名称
row	必选	long	表格行号
col	必选	long	表格列号

说明：
第一个参数是sheet名称，第二个参数是新区域左上角单元格所在行，第三个参数是新区域左上角单元格所在列。

使用示例：

javascript

// 基本用法
<script language="JScript" for="TANGER_OCX" event="OnSheetSelectionChange(SheetName, row, col)">
    console.log("Excel选择变化:");
    console.log("工作表:", SheetName);
    console.log("行号:", row);
    console.log("列号:", col);
</script>

// 处理选择变化
<script language="JScript" for="TANGER_OCX" event="OnSheetSelectionChange(SheetName, row, col)">
    console.log("Excel选择区域已改变");
    
    try {
        // 获取选择信息
        console.log("当前工作表:", SheetName);
        console.log("选择位置: 行", row, "列", col);
        
        // 可以执行其他操作
        // handleSelectionChange(SheetName, row, col);
        
        // 可以记录选择变化
        // logSelectionChange(SheetName, row, col);
    } catch(err) {
        console.error("处理选择变化时出错:", err);
    }
</script>

// 根据选择位置执行不同操作
<script language="JScript" for="TANGER_OCX" event="OnSheetSelectionChange(SheetName, row, col)">
    console.log("处理选择变化:", SheetName, row, col);
    
    // 根据行号执行不同操作
    if (row === 1) {
        console.log("选择了标题行");
        // 处理标题行选择
        // handleHeaderRowSelection(SheetName, col);
    } else if (row > 1) {
        console.log("选择了数据行");
        // 处理数据行选择
        // handleDataRowSelection(SheetName, row, col);
    }
    
    // 根据列号执行不同操作
    if (col === 1) {
        console.log("选择了第一列");
        // 处理第一列选择
        // handleFirstColumnSelection(SheetName, row);
    }
</script>

双击事件

OnSheetBeforeDoubleClick

语法：

javascript

OnSheetBeforeDoubleClick(SheetName, row, col, IsCancel)

功能：
该事件在EXCEL双击事件发生之前激活。

参数：

名称	必选/可选	数据类型	说明
SheetName	必选	string	工作表名称
row	必选	long	表格行号
col	必选	long	表格列号
IsCancel	必选	bool	是否取消操作

说明：
第一个参数是sheet名称，第二个参数是新区域左上角单元格所在行，第三个参数是新区域左上角单元格所在列。第4个参数是是否取消事件。在WEB编程中，第4个参数不能使用，而应该在此事件中，使用CancelSheetDoubleClick属性设置为true来取消事件。

使用示例：

javascript

// 基本用法
<script language="JScript" for="TANGER_OCX" event="OnSheetBeforeDoubleClick(SheetName, row, col, IsCancel)">
    console.log("Excel双击事件:");
    console.log("工作表:", SheetName);
    console.log("行号:", row);
    console.log("列号:", col);
    console.log("是否取消:", IsCancel);
</script>

// 处理双击事件
<script language="JScript" for="TANGER_OCX" event="OnSheetBeforeDoubleClick(SheetName, row, col, IsCancel)">
    console.log("准备处理Excel双击事件");
    
    try {
        console.log("双击位置: 工作表", SheetName, "行", row, "列", col);
        
        // 根据双击位置决定行为
        if (row === 1 && col === 1) {
            console.log("双击A1单元格，执行特殊操作");
            // 执行特殊操作
            // handleA1DoubleClick(SheetName);
        } else {
            console.log("双击其他单元格，进入编辑模式");
            // 进入编辑模式
            // enterEditMode(SheetName, row, col);
        }
    } catch(err) {
        console.error("处理双击事件时出错:", err);
    }
</script>

// 自定义双击行为
<script language="JScript" for="TANGER_OCX" event="OnSheetBeforeDoubleClick(SheetName, row, col, IsCancel)">
    console.log("自定义Excel双击行为");
    
    try {
        // 根据工作表名称决定行为
        if (SheetName === "数据表") {
            console.log("数据表双击，进入数据编辑");
            // 进入数据编辑模式
            // enterDataEditMode(row, col);
        } else if (SheetName === "汇总表") {
            console.log("汇总表双击，查看详细信息");
            // 查看详细信息
            // viewDetailInfo(row, col);
        } else {
            console.log("其他工作表双击，默认编辑");
            // 默认编辑行为
            // defaultEditBehavior(SheetName, row, col);
        }
    } catch(err) {
        console.error("处理自定义双击行为时出错:", err);
    }
</script>

右键事件

OnSheetBeforeRightClick

语法：

javascript

OnSheetBeforeRightClick(SheetName, row, col, IsCancel)

功能：
该事件在EXCEL右键事件发生之前激活。

参数：

名称	必选/可选	数据类型	说明
SheetName	必选	string	工作表名称
row	必选	long	表格行号
col	必选	long	表格列号
IsCancel	必选	bool	是否取消操作

说明：
第一个参数是sheet名称，第二个参数是新区域左上角单元格所在行，第三个参数是新区域左上角单元格所在列。第4个参数是是否取消事件。在WEB编程中，第4个参数不能使用，而应该在此事件中，使用CancelSheetRightClick属性设置为true来取消事件。

使用示例：

javascript

// 基本用法
<script language="JScript" for="TANGER_OCX" event="OnSheetBeforeRightClick(SheetName, row, col, IsCancel)">
    console.log("Excel右键事件:");
    console.log("工作表:", SheetName);
    console.log("行号:", row);
    console.log("列号:", col);
    console.log("是否取消:", IsCancel);
</script>

// 处理右键事件
<script language="JScript" for="TANGER_OCX" event="OnSheetBeforeRightClick(SheetName, row, col, IsCancel)">
    console.log("准备处理Excel右键事件");
    
    try {
        console.log("右键位置: 工作表", SheetName, "行", row, "列", col);
        
        // 根据右键位置决定菜单内容
        if (row === 1) {
            console.log("右键标题行，显示标题相关菜单");
            // 显示标题相关菜单
            // showHeaderMenu(SheetName, col);
        } else {
            console.log("右键数据行，显示数据相关菜单");
            // 显示数据相关菜单
            // showDataMenu(SheetName, row, col);
        }
    } catch(err) {
        console.error("处理右键事件时出错:", err);
    }
</script>

// 自定义右键菜单
<script language="JScript" for="TANGER_OCX" event="OnSheetBeforeRightClick(SheetName, row, col, IsCancel)">
    console.log("自定义Excel右键菜单");
    
    try {
        // 根据工作表类型决定菜单
        if (SheetName.includes("数据")) {
            console.log("数据表右键，显示数据操作菜单");
            // 显示数据操作菜单
            // showDataOperationMenu(row, col);
        } else if (SheetName.includes("汇总")) {
            console.log("汇总表右键，显示汇总操作菜单");
            // 显示汇总操作菜单
            // showSummaryOperationMenu(row, col);
        } else {
            console.log("其他表右键，显示默认菜单");
            // 显示默认菜单
            // showDefaultMenu(SheetName, row, col);
        }
    } catch(err) {
        console.error("处理自定义右键菜单时出错:", err);
    }
</script>

单元格变化事件

OnSheetChange

语法：

javascript

OnSheetChange(SheetName, row, col)

功能：
该事件在Excel单元格被改变时触发。

参数：

名称	必选/可选	数据类型	说明
SheetName	必选	string	工作表名称
row	必选	long	表格行号
col	必选	long	表格列号

说明：
第一个参数是sheet名称，第二个参数是新区域左上角单元格所在行，第三个参数是新区域左上角单元格所在列。

使用示例：

javascript

// 基本用法
<script language="JScript" for="TANGER_OCX" event="OnSheetChange(SheetName, row, col)">
    console.log("Excel单元格变化:");
    console.log("工作表:", SheetName);
    console.log("行号:", row);
    console.log("列号:", col);
</script>

// 处理单元格变化
<script language="JScript" for="TANGER_OCX" event="OnSheetChange(SheetName, row, col)">
    console.log("Excel单元格内容已改变");
    
    try {
        console.log("变化位置: 工作表", SheetName, "行", row, "列", col);
        
        // 可以执行其他操作
        // handleCellChange(SheetName, row, col);
        
        // 可以记录单元格变化
        // logCellChange(SheetName, row, col);
    } catch(err) {
        console.error("处理单元格变化时出错:", err);
    }
</script>

// 根据单元格位置执行不同操作
<script language="JScript" for="TANGER_OCX" event="OnSheetChange(SheetName, row, col)">
    console.log("处理单元格变化:", SheetName, row, col);
    
    // 根据行号执行不同操作
    if (row === 1) {
        console.log("标题行发生变化");
        // 处理标题行变化
        // handleHeaderRowChange(SheetName, col);
    } else if (row > 1) {
        console.log("数据行发生变化");
        // 处理数据行变化
        // handleDataRowChange(SheetName, row, col);
    }
    
    // 根据列号执行不同操作
    if (col === 1) {
        console.log("第一列发生变化");
        // 处理第一列变化
        // handleFirstColumnChange(SheetName, row);
    }
</script>

// 记录单元格变化
<script language="JScript" for="TANGER_OCX" event="OnSheetChange(SheetName, row, col)">
    var timestamp = new Date().toISOString();
    console.log("单元格变化记录:");
    console.log("工作表:", SheetName);
    console.log("位置: 行", row, "列", col);
    console.log("时间:", timestamp);
    
    // 可以记录到后台系统
    // logCellChange(SheetName, row, col, timestamp);
</script>

方法分类总结

分类	事件	功能	说明
选择变化	`OnSheetSelectionChange`	选择区域改变时触发	选择变化处理
双击事件	`OnSheetBeforeDoubleClick`	双击事件发生前触发	双击行为处理
右键事件	`OnSheetBeforeRightClick`	右键事件发生前触发	右键菜单处理
单元格变化	`OnSheetChange`	单元格内容改变时触发	单元格变化处理

使用流程

1. 基本EXCEL事件处理流程

javascript

// 基本EXCEL事件处理流程
function basicExcelEventHandling() {
    // 选择变化事件处理
    function handleSelectionChange(sheetName, row, col) {
        console.log("选择变化:", sheetName, row, col);
        // 处理选择变化
    }
    
    // 双击事件处理
    function handleDoubleClick(sheetName, row, col, isCancel) {
        console.log("双击事件:", sheetName, row, col, isCancel);
        // 处理双击事件
    }
    
    // 右键事件处理
    function handleRightClick(sheetName, row, col, isCancel) {
        console.log("右键事件:", sheetName, row, col, isCancel);
        // 处理右键事件
    }
}

2. 高级EXCEL事件处理流程

javascript

// 高级EXCEL事件处理流程
function advancedExcelEventHandling() {
    // EXCEL事件配置
    var excelEventConfig = {
        enableLogging: true,
        enableCustomHandling: true,
        enableCellTracking: true
    };
    
    // 处理选择变化
    function handleAdvancedSelectionChange(sheetName, row, col) {
        if (excelEventConfig.enableLogging) {
            console.log("选择变化日志:", sheetName, row, col);
        }
        
        if (excelEventConfig.enableCustomHandling) {
            // 执行自定义处理
        }
    }
    
    // 处理单元格变化
    function handleAdvancedCellChange(sheetName, row, col) {
        if (excelEventConfig.enableCellTracking) {
            console.log("单元格变化跟踪:", sheetName, row, col);
        }
        
        if (excelEventConfig.enableCustomHandling) {
            // 执行自定义处理
        }
    }
}

3. EXCEL事件质量控制流程

javascript

// EXCEL事件质量控制流程
function excelEventQualityControl() {
    // 处理EXCEL事件质量控制
    function controlExcelEventQuality() {
        var excelEventQuality = {
            totalEvents: 0,
            successfulEvents: 0,
            failedEvents: 0,
            qualityScore: 0
        };
        
        // 计算质量分数
        if (excelEventQuality.totalEvents > 0) {
            excelEventQuality.qualityScore = (excelEventQuality.successfulEvents / excelEventQuality.totalEvents) * 100;
        }
        
        console.log("EXCEL事件质量控制:", excelEventQuality);
        return excelEventQuality;
    }
    
    // 执行质量控制
    var qualityResult = controlExcelEventQuality();
    console.log("EXCEL事件质量控制结果:", qualityResult);
}

完整示例

1. 基础EXCEL事件处理

javascript

// 基础EXCEL事件处理示例
function basicExcelEventHandling() {
    // 选择变化处理
    function onSelectionChange(sheetName, row, col) {
        console.log("选择变化:", sheetName, row, col);
        // 处理选择变化
    }
    
    // 单元格变化处理
    function onCellChange(sheetName, row, col) {
        console.log("单元格变化:", sheetName, row, col);
        // 处理单元格变化
    }
}

2. 高级EXCEL事件处理

javascript

// 高级EXCEL事件处理示例
function advancedExcelEventHandling() {
    // EXCEL事件管理
    var excelEventManager = {
        isSelectionEnabled: true,
        isDoubleClickEnabled: true,
        isRightClickEnabled: true,
        isCellChangeEnabled: true
    };
    
    // 处理选择变化
    function handleSelectionChange(sheetName, row, col) {
        if (excelEventManager.isSelectionEnabled) {
            console.log("选择变化处理:", sheetName, row, col);
            // 处理选择变化
        }
    }
    
    // 处理单元格变化
    function handleCellChange(sheetName, row, col) {
        if (excelEventManager.isCellChangeEnabled) {
            console.log("单元格变化处理:", sheetName, row, col);
            // 处理单元格变化
        }
    }
}

3. EXCEL事件质量控制

javascript

// EXCEL事件质量控制示例
function excelEventQualityControl() {
    // EXCEL事件质量控制
    function controlExcelEventQuality() {
        var excelEventQuality = {
            selectionChanges: 0,
            doubleClicks: 0,
            rightClicks: 0,
            cellChanges: 0,
            errors: []
        };
        
        // 监控EXCEL事件质量
        function monitorExcelEventQuality(eventType, success) {
            if (success) {
                excelEventQuality[eventType]++;
            } else {
                excelEventQuality.errors.push({
                    event: eventType,
                    timestamp: new Date().toISOString()
                });
            }
        }
        
        console.log("EXCEL事件质量控制:", excelEventQuality);
        return excelEventQuality;
    }
    
    // 执行质量控制
    var qualityResult = controlExcelEventQuality();
    console.log("EXCEL事件质量控制结果:", qualityResult);
}

注意事项

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

错误处理

javascript

// EXCEL事件错误处理
function handleExcelEventError(eventType, error) {
    console.error("EXCEL事件处理失败:", eventType, error.message);
    
    switch(eventType) {
        case 'OnSheetSelectionChange':
            console.log("选择变化事件失败，请检查:");
            console.log("1. 工作表名称是否正确");
            console.log("2. 行列号是否有效");
            console.log("3. 选择变化处理是否正确");
            break;
        case 'OnSheetBeforeDoubleClick':
            console.log("双击事件失败，请检查:");
            console.log("1. 双击位置是否正确");
            console.log("2. 双击事件处理是否正确");
            console.log("3. 取消属性设置是否正确");
            break;
        case 'OnSheetChange':
            console.log("单元格变化事件失败，请检查:");
            console.log("1. 单元格位置是否正确");
            console.log("2. 单元格变化处理是否正确");
            console.log("3. 工作表状态是否正常");
            break;
        default:
            console.log("未知EXCEL事件处理失败");
    }
}

最佳实践

1. EXCEL事件管理最佳实践

javascript

// EXCEL事件管理最佳实践
function excelEventManagementBestPractice() {
    // EXCEL事件配置
    var excelEventConfig = {
        enableLogging: true,
        enableCustomHandling: true,
        enableCellTracking: true,
        enableQualityControl: true
    };
    
    // 应用EXCEL事件配置
    function applyExcelEventConfig() {
        try {
            // 设置EXCEL事件处理
            if (excelEventConfig.enableLogging) {
                console.log("EXCEL事件日志已启用");
            }
            
            if (excelEventConfig.enableCustomHandling) {
                console.log("自定义处理已启用");
            }
            
            console.log("EXCEL事件配置应用成功");
        } catch (error) {
            handleExcelEventError('applyExcelEventConfig', error);
        }
    }
    
    // 应用配置
    applyExcelEventConfig();
}

2. EXCEL事件质量控制最佳实践

javascript

// EXCEL事件质量控制最佳实践
function excelEventQualityControlBestPractice() {
    // EXCEL事件质量控制
    function controlExcelEventQuality() {
        try {
            // EXCEL事件质量控制
            var excelEventQuality = {
                totalEvents: 0,
                successfulEvents: 0,
                failedEvents: 0,
                qualityScore: 0
            };
            
            // 计算质量分数
            if (excelEventQuality.totalEvents > 0) {
                excelEventQuality.qualityScore = (excelEventQuality.successfulEvents / excelEventQuality.totalEvents) * 100;
            }
            
            console.log("EXCEL事件质量控制完成:", excelEventQuality);
            return excelEventQuality;
        } catch (error) {
            console.error("EXCEL事件质量控制失败:", error.message);
            return null;
        }
    }
    
    // 执行质量控制
    var qualityResult = controlExcelEventQuality();
    console.log("EXCEL事件质量控制结果:", qualityResult);
}

技术要点

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

EXCEL相关事件 ​

概述 ​

选择变化事件 ​

OnSheetSelectionChange ​

双击事件 ​

OnSheetBeforeDoubleClick ​

右键事件 ​

OnSheetBeforeRightClick ​

单元格变化事件 ​

OnSheetChange ​

方法分类总结 ​

使用流程 ​

1. 基本EXCEL事件处理流程 ​

2. 高级EXCEL事件处理流程 ​

3. EXCEL事件质量控制流程 ​

完整示例 ​

1. 基础EXCEL事件处理 ​

2. 高级EXCEL事件处理 ​

3. EXCEL事件质量控制 ​

注意事项 ​

错误处理 ​

最佳实践 ​

1. EXCEL事件管理最佳实践 ​

2. EXCEL事件质量控制最佳实践 ​

技术要点 ​

EXCEL相关事件

概述

选择变化事件

OnSheetSelectionChange

双击事件

OnSheetBeforeDoubleClick

右键事件

OnSheetBeforeRightClick

单元格变化事件

OnSheetChange

方法分类总结

使用流程

1. 基本EXCEL事件处理流程

2. 高级EXCEL事件处理流程

3. EXCEL事件质量控制流程

完整示例

1. 基础EXCEL事件处理

2. 高级EXCEL事件处理

3. EXCEL事件质量控制

注意事项

错误处理

最佳实践

1. EXCEL事件管理最佳实践

2. EXCEL事件质量控制最佳实践

技术要点