选区(Selection)

Selection 对象，表示选区相关

方法列表

方法	说明
GetSelectionType()	获取选区类型
IsCell()	判断是否选中单元格
IsRowSelect()	判断是否选中行
SelectCell()	选中单元格
SelectRow()	选中行
SelectCol()	选中列
SelectRange()	设置选区

GetSelectionType()

获取选区类型

语法

表达式.ActiveDBSheet.Selection.GetSelectionType()

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

返回值

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

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

示例

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 表示是否有选中单元格

示例

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 表示是否有选中行

示例

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 坐标】

示例

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		是	对应的行

示例

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

  const app = instance.Application

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

SelectCol()

选中列

语法

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

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

参数

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

示例

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		是	列结束位置【纵向】

示例

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

  const app = instance.Application

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