Skip to content

选区(Selection)

Selection 对象,表示选区相关

方法列表

方法说明
获取选区类型
判断是否选中单元格
判断是否选中行
选中单元格
选中行
选中列
设置选区

GetSelectionType()

获取选区类型

语法

表达式.ActiveDBSheet.Selection.GetSelectionType()

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

返回值

返回下列内容中的任意一个,表示对应的选区类型:

  • Cell:单个单元格
  • Row:单行
  • Column:单列
  • MultiRow:选中多行
  • Area:选中一个区域

示例

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

  const app = instance.Application

  // 获取选区类型
  const type = await app.ActiveDBSheet.Selection.GetSelectionType()
  console.log(type)
}

IsCell()

判断是否选中单元格

语法

表达式.ActiveDBSheet.Selection.IsCell()

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

返回值

返回 Boolean 表示是否有选中单元格

示例

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

  const app = instance.Application

  // 判断是否选中单元格
  const isRowSelect = await app.ActiveDBSheet.Selection.IsCell()
  console.log(isRowSelect)
}

IsRowSelect()

判断是否选中行

语法

表达式.ActiveDBSheet.Selection.IsRowSelect({ ViewRow })

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

参数

属性数据类型默认值必填说明
ViewRow
Number
需要判断的行

返回值

返回 Boolean 表示是否有选中行

示例

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

  const app = instance.Application

  // 判断是否选中行
  const isRowSelect = await app.ActiveDBSheet.Selection.IsRowSelect(3)
  console.log(isRowSelect)
}

SelectCell()

选中单元格

语法

表达式.ActiveDBSheet.Selection.SelectCell({ ViewRow, ViewCol })

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

参数

属性数据类型默认值必填说明
ViewRow
Number
单元格的行【x 坐标】
ViewCol
Number
单元格的列【y 坐标】

示例

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

  const app = instance.Application

  // 选中单元格
  await app.ActiveDBSheet.Selection.SelectCell({
    ViewRow: 4, // 单元格的行【x 坐标】
    ViewCol: 4 // 单元格的列【y 坐标】
  })
}

SelectRow()

选中行

语法

表达式.ActiveDBSheet.Selection.SelectRow({ ViewRow })

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

参数

属性数据类型默认值必填说明
ViewRow
Number
对应的行

示例

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

  const app = instance.Application

  // 选中行
  await app.ActiveDBSheet.Selection.SelectRow({
    ViewRow: 4 // 对应的行
  })
}

SelectCol()

选中列

语法

表达式.ActiveDBSheet.Selection.SelectCol({ ViewCol })

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

参数

属性数据类型默认值必填说明
ViewCol
Number
对应的列

示例

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

  const app = instance.Application

  // 选中列
  await app.ActiveDBSheet.Selection.SelectCol({
    ViewCol: 4 // 对应的列
  })
}

SelectRange()

设置选区

语法

表达式.ActiveDBSheet.Selection.SelectRange({ RowFrom, RowTo, ColFrom, ColTo })

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

参数

属性数据类型默认值必填说明
RowFrom
Number
行开始位置【横向】
RowTo
Number
行结束位置【横向】
ColFrom
Number
列开始位置【纵向】
ColTo
Number
列结束位置【纵向】

示例

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

  const app = instance.Application

  // 设置选区
  await app.ActiveDBSheet.Selection.SelectRange({
    RowFrom: 1, // 行开始位置【横向】
    RowTo: 3, // 行结束位置【横向】
    ColFrom: 1, // 列开始位置【纵向】
    ColTo: 3 // 列结束位置【纵向】
  })
}