Python Excel操作模块XlsxWriter之插入按钮 worksheet.insert_button()

worksheet.insert_button()

insert_button(row, col[, options])

向工作表插入一个VBA按钮控件。

参数：

• row(int) - 单元格所在的行（索引从0开始计数）。
• col(int) - 单元格所在的列（索引从0开始计数）。
• options(dict) - 可选的按钮位置，缩放参数。

insert_button()方法可以用于向工作表插入Excel表单按钮。

这个方法通常仅在与工作簿add_vab_project()方法一起使用时才有用，以便将该按钮与嵌入VBA项目中的宏关联起来：

# 添加二进制VBA项目。
workbook.add_vba_project('./vbaProject.bin')

# 在VBA项目中添加按钮并与宏关联起来。
worksheet.insert_button('B3',{'macro':   'say_hello',
                              'caption': 'Press Me'})

insert_button()方法接收字典形式的可选参数来定位和缩放按钮。可用的参数和它们的默认值有：

{
    'macro':    None,
    'caption':  'Button 1',
    'width':    64,
    'height':   20.
    'x_offset': 0,
    'y_offset': 0,
    'x_scale':  1,
    'y_scale':  1,
}

marco选项是用于设置当用户点击时调用的宏。宏应当通过上面演示的工作簿的add_vba_project()方法来添加。

caption用于设置按钮的说明。默认是值是Button n，n代表按钮的数量。

默认的按钮width是64像素，height是20像素，也就是单元格的默认宽度和高度。

offset和scale选项和insert_chart()的一样。