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()的一样。