阿里云首页 智能媒体管理

活动工作表

活动工作表对象

活动工作簿中的活动工作表。

语法:

表达式.ActiveWorkbook.ActiveSheet

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;
}

可编辑区域

可编辑区域对象

活动工作簿中的活动工作表的可编辑区域。

语法:

表达式.ActiveWorkbook.ActiveSheet.AllowEditRanges

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 可编辑区域
  const allowEditRanges = await activeSheet.AllowEditRanges;
}

添加可编辑区域

在受保护的工作表(Sheet)中添加一个可编辑区域。

语法:

表达式.ActiveWorkbook.ActiveSheet.AllowEditRanges.Add({ Title, Range, Password })

表达式:文档类型应用对象

参数:

属性

数据类型

默认值

必填

说明

Range

Object

1

Range 对象

Title

String

1

标题

Password

String

1

密码

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 可编辑区域
  const allowEditRanges = await activeSheet.AllowEditRanges;

  // 范围:左上角至 A1,右下角至 E20
  const range = await activeSheet.Range('$A1:$E20');

  // 添加可编辑区域
  await allowEditRanges.Add(undefined, range, 'WebOffice');
}

图表对象

工作表上的所有图表。

语法:

表达式.ActiveWorkbook.ActiveSheet.ChartObjects

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 工作表上的所有图表
  const chartObjects = await activeSheet.ChartObjects;
}

工作表上的所有行,返回的是一个 Range 对象。

语法:

表达式.ActiveWorkbook.ActiveSheet.Rows

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 工作表上的所有行
  const chartObjects = await activeSheet.Rows;
}

工作表上的所有列,返回的是一个 Range 对象。

语法:

表达式.ActiveWorkbook.ActiveSheet.Columns

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 工作表上的所有列
  const chartObjects = await activeSheet.Columns;
}

单元格

工作表上的所有单元格,返回的是一个 Range 对象。

语法:

表达式.ActiveWorkbook.ActiveSheet.Cells

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 工作表上的所有单元格
  const cells = await activeSheet.Cells;
}

删除工作表

语法:

表达式.ActiveWorkbook.ActiveSheet.Delete()

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 删除工作表
  await activeSheet.Delete();
}

索引

工作表对应索引号。

语法:

表达式.ActiveWorkbook.ActiveSheet.Index

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 工作表对应索引号
  const index = await activeSheet.Index;
  console.log(index);
}

名称管理器

返回一个 Names 集合,该集合代表所有工作表特定的名称。

语法:

表达式.ActiveWorkbook.ActiveSheet.Names

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 返回一个 Names 集合,该集合代表所有工作表特定的名称
  const names = await activeSheet.Names;
}

保护工作表

保护工作表使其不被修改。

语法:

表达式.ActiveWorkbook.ActiveSheet.Protect({ Password, DrawingObjects, Scenarios, AllowFormattingCells, AllowFormattingColumns, AllowFormattingRows, AllowInsertingColumns, AllowInsertingRows, AllowInsertingHyperlinks, AllowDeletingColumns, AllowDeletingRows, AllowSorting, AllowFiltering, AllowUsingPivotTables })

表达式:文档类型应用对象

参数:

属性

数据类型

默认值

必填

说明

Password

String

指定工作表或工作簿的区分大小写密码的字符串。如果省略此参数,可以不使用密码地解除对工作表或工作簿的保护。否则,必须指定密码才能解除对工作表或工作簿的保护。如果忘记密码,则无法解除对工作表或工作簿的保护

DrawingObjects

Boolean

false

如果为 true,则保护形状

Scenarios

Boolean

true

如果为 true,则保护方案。此参数仅对工作表有效

AllowFormattingCells

Boolean

false

如果为 true,则允许用户格式化受保护工作表上的任何单元格

AllowFormattingColumns

Boolean

false

如果为 true,则允许用户格式化受保护工作表上的任何列

AllowFormattingRows

Boolean

false

如果为 true,则允许用户格式化受保护的工作表上的任何行

AllowInsertingColumns

Boolean

false

如果为 true,则允许用户在受保护工作表上插入列

AllowInsertingRows

Boolean

false

如果为 true,则允许用户在受保护工作表上插入行

AllowInsertingHyperlinks

Boolean

false

如果为 true,则允许用户在受保护的工作表上插入超链接

AllowDeletingColumns

Boolean

false

如果为 true,则允许用户在受保护的工作表上删除列,其中要删除的列中的每个单元格都处于解锁状态

AllowDeletingRows

Boolean

false

如果为 true,则允许用户在受保护的工作表上删除行,其中要删除的行中的每个单元格都处于解锁状态

AllowSorting

Boolean

false

如果为 true,则允许用户对受保护工作表进行排序。排序范围内的每个单元都必须处于解锁或不受保护的状态

AllowFiltering

Boolean

false

如果为 true,则允许用户在受保护的工作表上设置筛选。用户可以更改筛选条件,但无法启用或禁用自动筛选。 用户可以在现有自动筛选上设置筛选

AllowUsingPivotTables

Boolean

false

如果为 true,则允许用户在受保护的工作表上使用数据透视表

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 输入密码
  activeSheet.Protect('123456');
}

解除保护

去除工作表或工作簿中的保护。如果工作表或工作簿不是受保护的,则此方法不起作用。

语法:

表达式.ActiveWorkbook.ActiveSheet.Unprotect({ Password })

表达式:文档类型应用对象

参数:

属性

数据类型

必填

说明

Password

String

设置的密码

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 解除密码
  activeSheet.Unprotect('123456');
}

图形

当前工作表上的所有 Shape 对象的集合。

语法:

表达式.ActiveWorkbook.ActiveSheet.Shapes

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 当前工作表上的所有 Shape 对象的集合
  const shapes = await activeSheet.Shapes;
}

是否可见

工作表是否可见。

语法:

表达式.ActiveWorkbook.ActiveSheet.Visible

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;

  // 工作表不可见
  activeSheet.Visible = false;
}

所用区域对象

工作表上的所用区域,返回 Range 区域对象。

语法:

表达式.ActiveWorkbook.ActiveSheet.UsedRange

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;
  
  // 工作表上的所用区域
  const UsedRange = await activeSheet.UsedRange;
}

区域对象

返回一个 Range 对象,它表示一个单元格或单元格区域。

语法:

表达式.ActiveWorkbook.ActiveSheet.Range

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet;
  
  // 返回一个 Range 对象,它表示一个单元格或单元格区域
  const range = await activeSheet.UsedRange;
}