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

关注

翻译最新推荐文章于 2026-06-07 12:05:05 发布 4.2k 阅读 AI 写同款· GEO 优化 ›

用Python重写Excel工作流：多源数据清洗与自动化报告实战 Excel作为经典电子表格工具，其单元格公式驱动架构在面对多源异构数据整合、结构化清洗复用及大规模可视化时存在天然瓶颈。Python凭借pandas的数据处理能力、SQLAlchemy的数据库直连支持、XlsxWriter的精准报表生成以及Bokeh的交互式可视化，构建起可审计、可复用、可调度的工业化数据流水线。本文围绕JVM日志分析与性能测试报告场景，详解如何将Excel中易出错的手动操作（如跨文件公式引用、格式修复、图表重绘）转化为稳定可追溯的Python脚本，尤其聚焦JSON/CSV/XML多格式容错阅读详情

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

收录于