深色模式
控制台
获取下拉列表内容控件中的所有项,只读。
属性 | 说明 |
---|---|
获取下拉内容控件中列表的总数量 |
方法 | 说明 |
---|---|
将新的列表项添加到下拉列表或组合框内容控件,并返回 ContentControlListEntry 对象,代表下拉内容控件的下拉列表中单个下拉选项 | |
从下拉列表或组合框内容控件中清除所有项 | |
从下拉列表或组合框内容控件中取消选中列表项 | |
返回一个 ContentControlListEntry 对象,该对象代表集合中的指定项 | |
返回或设置一个字符串,表示下拉列表或组合框内容控件的列表项的显示文本 | |
返回或设置一个字符串,表示下拉列表或组合框内容控件的列表项的值 | |
删除组合框或下拉列表内容控件中的指定项 | |
选择下拉列表或组合框内容控件中的列表项,将内容控件的文本设置为项的值 |
获取下拉内容控件中列表的总数量
表达式.ActiveDocument.ContentControls.Item(Index).DropdownListEntries.Count
表达式:文档类型应用对象
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 获取该下拉内容控件的下拉列表
const ContentControlListEntries = await ContentControl.DropdownListEntries
// 给该控件添加选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControlListEntries.Add({
Text: 'Text 2'
})
// 获取下拉内容控件中列表的总数量
const Count = await ContentControlListEntries.Count
console.log(Count)
}
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 获取文档中的内容控件数量(包含文本和下拉内容控件)
// 假设这里有 2 个(打印为 2),那么新增的那个内容控件就是第 2 个
const Count = await app.ActiveDocument.ContentControls.Count
// 获取第 2 个下拉内容控件的下拉列表
const ContentControlListEntries =
await app.ActiveDocument.ContentControls.Item(Count).DropdownListEntries
// 获取下拉内容控件中列表的总数量
const ListEntriesCount = await ContentControlListEntries.Count
console.log(ListEntriesCount)
}
将新的列表项添加到下拉列表或组合框内容控件,并返回 ContentControlListEntry 对象,代表下拉内容控件的下拉列表中单个下拉选项
表达式.ActiveDocument.ContentControls.Item(Index).DropdownListEntries.Add({ Text, Value, Index })
表达式:文档类型应用对象
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 2、获取该下拉内容控件的下拉列表
const ContentControlListEntries = await ContentControl.DropdownListEntries
// 3、给该控件添加选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 4、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControlListEntries.Add({
Text: 'Text 2'
})
}
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 2、获取文档中的内容控件数量(包含文本和下拉内容控件)
// 假设这里有 2 个(打印为 2),那么新增的那个内容控件就是第 2 个
const Count = await app.ActiveDocument.ContentControls.Count
// 3、获取第 2 个下拉内容控件的下拉列表
const ContentControlListEntries =
await app.ActiveDocument.ContentControls.Item(Count).DropdownListEntries
// 4、将新的列表项添加到下拉列表或组合框内容控件,并返回 ContentControlListEntry 对象,代表下拉内容控件的下拉列表中单个下拉选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
}
从下拉列表或组合框内容控件中清除所有项
表达式.ActiveDocument.ContentControls.Item(Index).DropdownListEntries.Clear()
表达式:文档类型应用对象
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 2、获取该下拉内容控件的下拉列表
const ContentControlListEntries = await ContentControl.DropdownListEntries
// 3、给该控件添加选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 4、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControlListEntries.Add({
Text: 'Text 2'
})
// 5、从下拉列表或组合框内容控件中清除所有项
setTimeout(async () => {
await ContentControlListEntries.Clear();
}, 3000)
}
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4,
})
// 2、获取文档中的内容控件数量(包含文本和下拉内容控件)
// 假设这里有 2 个(打印为 2),那么新增的那个内容控件就是第 2 个
const Count = await app.ActiveDocument.ContentControls.Count
// 3、获取第 2 个下拉内容控件的下拉列表
const ContentControlListEntries = await app.ActiveDocument.ContentControls.Item(Count).DropdownListEntries
// 4、将新的列表项添加到下拉列表或组合框内容控件,并返回 ContentControlListEntry 对象,代表下拉内容控件的下拉列表中单个下拉选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1,
})
// 5、从下拉列表或组合框内容控件中清除所有项
setTimeout(async () => {
await ContentControlListEntries.Clear()
}, 3000)
}
JSSDK: v1.1.15+、WebOffice v4.1.1+ 支持
从下拉列表或组合框内容控件中取消选中列表项
表达式.ActiveDocument.ContentControls.Item(Index).DropdownListEntries.UnSelect()
表达式:文档类型应用对象
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 2、获取该下拉内容控件的下拉列表
const ContentControlListEntries = await ContentControl.DropdownListEntries
// 3、给该控件添加选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 3、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControlListEntries.Add({
Text: 'Text 2'
})
// 4、进行第 1 项选中操作
await ContentControl.DropdownListEntries.Item(1).Select()
// 5、3 秒后进行取消选中操作
setTimeout(async () => {
await ContentControlListEntries.UnSelect()
}, 3000)
}
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await app.ActiveDocument.ContentControls.Add({
Type: 4
})
// 2、给该控件添加选项
await ContentControl.DropdownListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 2、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControl.DropdownListEntries.Add({
Text: 'Text 2'
})
// 3、获取文档中的内容控件数量(包含文本和下拉内容控件)
const count = await app.ActiveDocument.ContentControls.Count
console.log(count) // 假设这里有 2 个(打印为 2),那么新增的那个内容控件就是第 2 个
// 4、获取第 2 个下拉内容控件的下拉列表
const ContentControlListEntries =
await app.ActiveDocument.ContentControls.Item(2).DropdownListEntries
// 5、获取该下拉列表的第 1 个选项(Text 1)
const DropdownListEntry1 = await ContentControlListEntries.Item(1)
// 6、获取第 1 个选项的显示文本
const Value = await DropdownListEntry1.Value
console.log(Value)
// 7、确定是我们需要删除的下拉选项,进行选中操作
await DropdownListEntry1.Select()
// 8、3 秒后进行取消选中操作
setTimeout(async () => {
await ContentControlListEntries.UnSelect()
}, 3000)
}
返回一个 ContentControlListEntry
对象,该对象代表集合中的指定项
表达式.ActiveDocument.ContentControls.Item(Index).DropdownListEntries.Item(Index)
表达式:文档类型应用对象
属性 | 数据类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
Index | Number | 是 | 第 Index 个下拉列表的选项 |
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 2、获取该下拉内容控件的下拉列表
const ContentControlListEntries = await ContentControl.DropdownListEntries
// 3、给该控件添加选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 3、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControlListEntries.Add({
Text: 'Text 2'
})
// 4、获取第 1 项
const ContentControlListEntry1 = await ContentControl.DropdownListEntries.Item(1)
}
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await app.ActiveDocument.ContentControls.Add({
Type: 4
})
// 2、给该控件添加选项
await ContentControl.DropdownListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 2、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControl.DropdownListEntries.Add({
Text: 'Text 2'
})
// 3、获取文档中的内容控件数量(包含文本和下拉内容控件)
const count = await app.ActiveDocument.ContentControls.Count
console.log(count) // 假设这里有 2 个(打印为 2),那么新增的那个内容控件就是第 2 个
// 4、获取第 2 个下拉内容控件的下拉列表
const DropdownListEntries = await app.ActiveDocument.ContentControls.Item(2)
.DropdownListEntries
// 5、获取该下拉列表的第 1 个选项(Text 1)
const DropdownListEntry1 = await DropdownListEntries.Item(1)
}
返回或设置一个字符串,表示下拉列表或组合框内容控件的列表项的显示文本
表达式.ActiveDocument.ContentControls.Item(Index).DropdownListEntries.Item(Index).Text
表达式:文档类型应用对象
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 2、获取该下拉内容控件的下拉列表
const ContentControlListEntries = await ContentControl.DropdownListEntries
// 3、给该控件添加选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 3、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControlListEntries.Add({
Text: 'Text 2'
})
// 4、获取第 1 项的文本
const Text = await ContentControl.DropdownListEntries.Item(1).Text;
console.log(Text)
}
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await app.ActiveDocument.ContentControls.Add({
Type: 4
})
// 2、给该控件添加选项
await ContentControl.DropdownListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 2、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControl.DropdownListEntries.Add({
Text: 'Text 2'
})
// 3、获取文档中的内容控件数量(包含文本和下拉内容控件)
const count = await app.ActiveDocument.ContentControls.Count
console.log(count) // 假设这里有 2 个(打印为 2),那么新增的那个内容控件就是第 2 个
// 4、获取第 2 个下拉内容控件的下拉列表
const ContentControlListEntries =
await app.ActiveDocument.ContentControls.Item(2).DropdownListEntries
// 5、获取该下拉列表的第 1 个选项(Text 1)
const DropdownListEntry1 = await ContentControlListEntries.Item(1)
// 6、获取第 1 个选项的显示文本
const Value = await DropdownListEntry1.Value
console.log(Value)
// 7、确定是我们需要删除的下拉选项,进行文本获取
const Text = await DropdownListEntry1.Text
console.log(Text)
}
返回或设置一个字符串,表示下拉列表或组合框内容控件的列表项的值
表达式.ActiveDocument.ContentControls.Item(Index).DropdownListEntries.Item(Index).Value
表达式:文档类型应用对象
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 2、获取该下拉内容控件的下拉列表
const ContentControlListEntries = await ContentControl.DropdownListEntries
// 3、给该控件添加选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 3、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControlListEntries.Add({
Text: 'Text 2'
})
// 4、获取第 1 项的值
const Value = await ContentControl.DropdownListEntries.Item(1).Value
console.log(Value)
}
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await app.ActiveDocument.ContentControls.Add({
Type: 4
})
// 2、给该控件添加选项
await ContentControl.DropdownListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 2、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControl.DropdownListEntries.Add({
Text: 'Text 2'
})
// 3、获取文档中的内容控件数量(包含文本和下拉内容控件)
const count = await app.ActiveDocument.ContentControls.Count
console.log(count) // 假设这里有 2 个(打印为 2),那么新增的那个内容控件就是第 2 个
// 4、获取第 2 个下拉内容控件的下拉列表
const ContentControlListEntries =
await app.ActiveDocument.ContentControls.Item(2).DropdownListEntries
// 5、获取该下拉列表的第 1 个选项(Text 1)
const DropdownListEntry1 = await ContentControlListEntries.Item(1)
// 6、获取第 1 个选项的显示文本
const Text = await DropdownListEntry1.Text
console.log(Text)
// 7、确定是我们需要删除的下拉选项,进行值获取
const Value = await DropdownListEntry1.Value
console.log(Value)
}
删除组合框或下拉列表内容控件中的指定项
限制说明:
表达式.ActiveDocument.ContentControls.Item(Index).DropdownListEntries.Item(Index).Delete()
表达式:文档类型应用对象
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 2、获取该下拉内容控件的下拉列表
const ContentControlListEntries = await ContentControl.DropdownListEntries
// 3、给该控件添加选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 3、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControlListEntries.Add({
Text: 'Text 2'
})
// 4、进行第 1 项删除操作
await ContentControl.DropdownListEntries.Item(1).Delete();
}
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await app.ActiveDocument.ContentControls.Add({
Type: 4
})
// 2、给该控件添加选项
await ContentControl.DropdownListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 2、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControl.DropdownListEntries.Add({
Text: 'Text 2'
})
// 3、获取文档中的内容控件数量(包含文本和下拉内容控件)
const count = await app.ActiveDocument.ContentControls.Count
console.log(count) // 假设这里有 2 个(打印为 2),那么新增的那个内容控件就是第 2 个
// 4、获取第 2 个下拉内容控件的下拉列表
const ContentControlListEntries =
await app.ActiveDocument.ContentControls.Item(2).DropdownListEntries
// 5、获取该下拉列表的第 1 个选项(Text 1)
const DropdownListEntry1 = await ContentControlListEntries.Item(1)
// 6、获取第 1 个选项的显示文本
const Value = await DropdownListEntry1.Value
console.log(Value)
// 7、确定是我们需要删除的下拉选项,进行删除操作
await DropdownListEntry1.Delete()
}
选择下拉列表或组合框内容控件中的列表项,将内容控件的文本设置为项的值
表达式.ActiveDocument.ContentControls.Item(Index).DropdownListEntries.Item(Index).Select()
表达式:文档类型应用对象
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await ContentControls.Add({
Type: 4
})
// 2、获取该下拉内容控件的下拉列表
const ContentControlListEntries = await ContentControl.DropdownListEntries
// 3、给该控件添加选项
await ContentControlListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 3、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControlListEntries.Add({
Text: 'Text 2'
})
// 4、进行第 1 项选中操作
await ContentControl.DropdownListEntries.Item(1).Select()
}
//@file=base.docx
async function example() {
await instance.ready()
const app = instance.Application
// 内容控件对象
const ContentControls = await app.ActiveDocument.ContentControls
// 1、新增一个下拉内容控件
const ContentControl = await app.ActiveDocument.ContentControls.Add({
Type: 4
})
// 2、给该控件添加选项
await ContentControl.DropdownListEntries.Add({
Text: 'Text 1',
Value: 'Value 1',
Index: 1
})
// 2、给该控件添加选项:Value 和 Index 可以不填,这样 Value 会等于 Text,Index 就是添加到最后面
await ContentControl.DropdownListEntries.Add({
Text: 'Text 2'
})
// 3、获取文档中的内容控件数量(包含文本和下拉内容控件)
const count = await app.ActiveDocument.ContentControls.Count
console.log(count) // 假设这里有 2 个(打印为 2),那么新增的那个内容控件就是第 2 个
// 4、获取第 2 个下拉内容控件的下拉列表
const ContentControlListEntries =
await app.ActiveDocument.ContentControls.Item(2).DropdownListEntries
// 5、获取该下拉列表的第 1 个选项(Text 1)
const DropdownListEntry1 = await ContentControlListEntries.Item(1)
// 6、获取第 1 个选项的显示文本
const Value = await DropdownListEntry1.Value
console.log(Value)
// 7、确定是我们需要选中的下拉选项,进行选中操作
await DropdownListEntry1.Select()
}