如何通过Python win32com正确设置Visio形状的渐变填充停止点？

问题分析 #

你遇到的Unexpected end of file错误，核心原因是FillGradientStops的公式格式不符合Visio的语法要求。Visio对渐变停止点的公式有严格规范：

• 多个停止点之间必须用分号（;）分隔，而非冒号
• 位置参数可以用小数（0=起始，1=结束）或带%符号的百分比
• 每个停止点的结构为：颜色公式,位置,透明度

修正后的代码 #

import win32com.client as win32

app = win32.Dispatch('Visio.Application')
app.Visible = True
page = app.ActivePage

# 绘制矩形（也可替换为模具中的形状）
shape = page.DrawRectangle(1.0, 1.0, 2.0, 2.0)
shape.Text = "My shape name"

# 设置渐变填充基础属性
shape.Cells("FillGradientEnabled").FormulaU = "TRUE"
shape.Cells("FillGradientDir").FormulaU = "1"  # 1代表线性渐变，这是渐变类型而非角度
shape.Cells("FillGradientAngle").FormulaU = "45"  # 渐变角度45度

# 正确的渐变停止点公式：分号分隔停止点，位置支持小数或百分比
stops_formula = "RGB(255,0,0),0,0;RGB(0,0,255),1,0"
# 也可使用百分比写法："RGB(255,0,0),0%,0;RGB(0,0,255),100%,0"
shape.Cells("FillGradientStops").FormulaU = stops_formula

额外说明 #

• FillGradientDir的正确用法：该单元格控制渐变类型，线性渐变对应值为1，径向渐变对应2，之前错误赋值角度会导致渐变方向异常，需修正。
• 调试技巧：可在Visio中打开形状表（开发工具→显示形状表），查看FillGradientStops单元格的原生公式，对比调试自己的代码。
• 透明度参数：每个停止点的第三个参数为透明度（0=完全不透明，1=完全透明），无需透明时设为0即可。

内容的提问来源于stack exchange，提问作者Jack H L