视图(View) #

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

  const app = instance.Application

  // 清空视图指定区域单元格内容
  const result = await app.ActiveDBSheet.View.ClearRangeValues({
    RowFrom: 1, // 【行】开始位置
    RowTo: 1, // 【行】结束位置
    ColFrom: 1, // 【列】开始位置-在卡片视图就是第 N 行的第 M 个字段
    ColTo: 1 // 【列】结束位置-在卡片视图就是第 N 行的第 M 个字段
  })
}

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

  const app = instance.Application

  // 清空当前单元格内容
  await app.ActiveDBSheet.View.ClearValues()
}

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

  const app = instance.Application

  // 创建网格视图
  await app.ActiveDBSheet.View.CreateView({
    Type: 'Grid', // 视图类型-网格视图
    Name: 'WebOffice' // 视图名称
  })
}

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

  const app = instance.Application

  // 创建网格视图
  await app.ActiveDBSheet.View.CreateView({
    Type: 'Kanban', // 视图类型-网格视图
    Name: 'WebOffice' // 视图名称
  })
}

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

  const app = instance.Application

  // 获取 recordID
  const recordID = await app.ActiveDBSheet.View.GetRecordId({
    ViewRow: 1 // 行号
  })

  // 根据 RecordId 删除对应记录
  const result = await app.ActiveDBSheet.View.DeleteRecord({
    RecordId: recordID
  })
}

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

  const app = instance.Application

  // 获取当前视图 ID
  const id = await app.ActiveDBSheet.View.GetActiveViewId()

  // 根据视图 ID 删除视图
  await app.ActiveDBSheet.View.DeleteView({
    ID: id // 视图 id
  })
}

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

  const app = instance.Application

  // 删除行的数据
  const id = await app.ActiveDBSheet.View.DeleteViewRow({
    ViewRow: 1 // 行号
  })
}

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

  const app = instance.Application

  // 返回当前激活单元格信息
  const info = await app.ActiveDBSheet.View.GetActiveCell()
  console.log(info)
}

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

  const app = instance.Application

  // 获取当前视图 ID
  const info = await app.ActiveDBSheet.View.GetActiveViewId()
  console.log(info)
}

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

  const app = instance.Application

  // 获取 AtID 对应的位置
  const pos = await app.ActiveDBSheet.View.GetAtGridPos({
    AtID: 'xxx' // @ID
  })
  console.log(pos)
}

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

  const app = instance.Application

  // 读取网格行高
  const info = await app.ActiveDBSheet.View.GetGridRowHeight()
  console.log(info)
}

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

  const app = instance.Application

  // 获取分组依据，分组依据不对应分组条件项，不是按照分组条件返回的
  const data = await app.ActiveDBSheet.View.GetGroupByList()
  console.log(data)
}

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

  const app = instance.Application

  // 返回看板视图的最大滚动高度
  const Height = await app.ActiveDBSheet.View.GetKanbanScrollHeight()
  console.log('高度：', Height)
}

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

  const app = instance.Application

  // 从当前视图的可视行号获取 RecordID
  const id = await app.ActiveDBSheet.View.GetRecordId({
    ViewRow: 1 // 行号
  })

  // 从 RecordID 获取数据
  const info = await app.ActiveDBSheet.View.GetRecord({
    RecordId: id // 行号
  })
  console.log(info)
}

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

  const app = instance.Application

  // 获取当前视图的记录数
  const info = await app.ActiveDBSheet.View.GetRecordCount()
  console.log(info)
}

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

  const app = instance.Application

  // 从当前视图的可视行号获取 RecordID
  const id = await app.ActiveDBSheet.View.GetRecordId({
    ViewRow: 1 // 行号
  })
  console.log(id)
}

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

  const app = instance.Application

  // 获取滚动条的位置
  const pos = await app.ActiveDBSheet.View.GetScrollBar()
  console.log(pos)
}

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

  const app = instance.Application

  // 获取横向滚动条最大值
  const Value = await app.ActiveDBSheet.View.GetScrollXMax()
  console.log(Value)
}

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

  const app = instance.Application

  // 获取纵向滚动条最大值
  const Value = await app.ActiveDBSheet.View.GetScrollXMax()
  console.log(Value)
}

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

  const app = instance.Application

  // 返回当前选区信息
  const info = await app.ActiveDBSheet.View.GetSelection()
  console.log(info)
}

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

  const app = instance.Application

  // 获取文档绘制区域的尺寸
  const ViewSize = await app.ActiveDBSheet.View.GetViewRect()
  console.log('宽度：', ViewSize.Width)
  console.log('高度：', ViewSize.Height)
}

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

  const app = instance.Application

  // 先查询之前记录条数
  const oldCount = await app.ActiveDBSheet.View.GetRecordCount()

  // 往未指定分组添加记录数
  const id = await app.ActiveDBSheet.View.InsertRecord({
    RecordCount: 2 // 空白记录条数
  })

  // 插入 RecordCount 条空白记录到表中
  const count = await app.ActiveDBSheet.View.GetRecordCount() // 这里看出是新增了 2 条记录的（相比之前）
  console.log(count)

  console.log(oldCount - count === 2)
}

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

  const app = instance.Application

  // 跳转至指定@位置
  await app.ActiveDBSheet.View.JumpAtLocation({
    AtID: 'xxx' // @ID
  })
}

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

  const app = instance.Application

  // 将视图中的指定行移动到新的位置
  const id = await app.ActiveDBSheet.View.MoveRow({
    ViewRow: [1, 2], // 行号数组
    ToRow: 4 // 移动后的行号，注：实际移动至行号3的位置
  })
}

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

  const app = instance.Application

  // 获取当前视图 ID
  const id = await app.ActiveDBSheet.View.GetActiveViewId()

  // 修改视图名称
  await app.ActiveDBSheet.View.RenameView({
    ID: id, // 视图 id
    Name: 'WebOffice' // 视图名称
  })
}

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

  const app = instance.Application

  // 修改数据
  const id = await app.ActiveDBSheet.View.SetCellValue({
    ViewRow: 1, // 行号
    ViewCol: 1, // 列号-在卡片视图就是第 N 行的第 M 个字段
    Value: 'JSSDK' // 值
  })
}

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

  const app = instance.Application

  // 设置分组依据，建议结合View.GetGroupByList()使用
  await app.ActiveDBSheet.View.SetConditionField({
    Index: 1 // 索引
  })
}

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

  const app = instance.Application

  // 设置网格行高
  await app.ActiveDBSheet.View.SetGridRowHeight({
    RowHeightType: 'ExtraTall' // 2 倍行高
  })
}

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

  const app = instance.Application

  // 设置看板视图的滚动滑块位置
  await app.ActiveDBSheet.View.SetKanbanScrollPos({
    Value: 1080
  })
}

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

  const app = instance.Application

  // 设置绘制时某些元素不显示
  await app.ActiveDBSheet.View.SetRenderItemVisible({
    ItemName: 'colHeaderAddBtn', // 设置【增加新列】
    Visible: false // 不可见
  })
}

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

  const app = instance.Application

  // 设置横向滚动条是否可见
  await app.ActiveDBSheet.View.SetScrollVisible({
    Visible: false
  })
}

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

  const app = instance.Application

  // 设置滚动条横向滑块位置
  await app.ActiveDBSheet.View.SetScrollXPos({
    X: 100
  })
}

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

  const app = instance.Application

  // 设置滚动条纵向滑块位置
  await app.ActiveDBSheet.View.SetScrollYPos({
    Y: 100
  })
}

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

  const app = instance.Application

  // 跳转到指定表的指定行位置
  await app.ActiveDBSheet.View.TriggerLocation({
    SheetId: 1,    // 当前 Sheet 的索引
    RecordId: 'E', // 行号
    FieldId: 'E'   // 列号
  })
}