18 workbook.define_name()

优质
小牛编辑
123浏览
2023-12-01

define_name() 在workbook工作簿中创建一个作为变量使用的定义名称。

  • 参数:
    • name (字符串) – 定义的名称;
    • formula (字符串) – 定义名称的作用值、单元格或范围;

这个方法用于定义一个名称,其可以用来表示workbook工作簿中的值、单个单元格或范围。所以有时候也被成为“命名范围”

定义的名称通常用来借助其描述性的名称来简化或阐明公式,比如下面这样:

workbook.define_name('Exchange_rate', '=0.96')
worksheet.write('B3', '=B2*Exchange_rate')

就像在Excel中一样,这样创建的定义名称是全局性质的,任何sheet工作表都可以使用它:

# 全局的定义名称
workbook.define_name('Sales', '=Sheet1!$G$1:$H$10')

还可以通过使用语法sheet名称!定义名称的方式,来定义本地Sheet工作表的定义名称,如下所示:

# 本地的定义名称
workbook.define_name('Sheet2!Sales', '=Sheet2!$G$1:$G$10')

如果Sheet工作表名中包含空格或特殊符号,则必须遵循Excel的规范并将其用单引号包含起来,如下所示:

workbook.define_name("'New Data'!Sales", '=Sheet2!$G$1:$G$10')

Microsoft Office文档中有关如何在公式中定义和使用名称的解释说明了Excel中名称的规则