如何在Stimulsoft Report中为图片设置圆角效果？

方案1：椭圆形状控件实现（全版本通用） #

该方案无需编写代码，适配桌面端、Web端的预览和导出场景，是目前稳定性最高的实现方式：

• 插入椭圆（Ellipse）形状控件，将宽高调整为相同数值，保证最终显示为正圆。
• 打开椭圆控件的属性面板，找到填充（Fill）设置项，选择填充类型为图片（Image）。
• 导入需要显示的图片资源，将图片缩放模式设置为Zoom，保证图片按比例填充椭圆区域，即可直接得到50%圆角的正圆图片效果。
• 如果需要额外添加边框，可以在椭圆的*边框（Border）*属性中自定义边框颜色、粗细。

方案2：自定义CSS实现（仅适用Web端在线预览场景） #

如果报表仅用于Web端在线展示，不需要导出PDF、Excel等本地文件，可以通过注入自定义样式实现：

• 选中需要设置圆角的图片控件，打开属性面板的*自定义属性（Custom Attributes）*配置项。
• 添加自定义属性class，对应值设置为rounded-image。
• 在报表所在前端页面的CSS文件中添加如下代码：

.rounded-image img {
  border-radius: 50% !important;
}

注意该方案仅在线预览生效，导出的本地文件不会保留圆角效果。

避坑提示 #

• 不要直接给原生图片控件设置border-radius样式，StimulSoft的原生图片控件渲染逻辑会覆盖自定义样式，绝大多数场景无法生效。
• 圆形头像、固定圆角图片类需求优先使用方案1，导出PDF、打印都可以正常显示圆角效果。

内容的提问来源于stack exchange，提问作者Mehregan Nemani Sayyadi