5.1 KiB
5.1 KiB
图片参数 (Image Props)
图片参数来自 ImageProps（继承 PositionProps、DataOrPathProps、ObjectNameProps），用于 slide.addImage() 方法。
位置属性 (PositionProps)
-
x：水平位置
- 类型：
Coord（number |${number}%``） - 单位：英寸（number）或百分比（
'50%'）
- 类型：
-
y：垂直位置
- 类型：
Coord - 单位：英寸或百分比
- 类型：
-
w：宽度
- 类型：
Coord - 单位：英寸或百分比
- 类型：
-
h：高度
- 类型：
Coord - 单位：英寸或百分比
- 类型：
数据/路径属性 (DataOrPathProps)
-
path：图片 URL 或本地路径
- 类型：
string - 示例：
'https://onedrives.com/myimg.png'、'/home/gitbrent/images/myimg.png'
- 类型：
-
data：base64 编码数据
- 类型：
string - 格式：
'image/png;base64,iVtDafDrBF[...]=' - 说明：base64 编码的图片数据，用时可避免路径/服务器问题
- 类型：
对象名称属性 (ObjectNameProps)
- objectName：对象名称
- 类型：
string - 说明：替代默认的 "Object N" 名称，在 PowerPoint 选择窗格中显示
- 默认值：
'Object 1' - 始于：v3.10.0
- 类型：
图片专有属性 (ImageProps)
-
altText：替代文字（无障碍）
- 类型：
string - 说明：PowerPoint 中右击图片 > "编辑替代文字"
- 类型：
-
flipH：水平翻转
- 类型：
boolean - 取值范围：
true/false - 默认值：
false
- 类型：
-
flipV：垂直翻转
- 类型：
boolean - 取值范围：
true/false - 默认值：
false
- 类型：
-
hyperlink：超链接
- 类型：
HyperlinkProps - 子参数：
- hyperlink.slide：链接到页码
- 类型：
number
- 类型：
- hyperlink.url：链接 URL
- 类型：
string
- 类型：
- hyperlink.tooltip：超链接提示
- 类型：
string
- 类型：
- hyperlink.slide：链接到页码
- 类型：
-
placeholder：占位符类型
- 类型：
string - 取值范围：
'body'、'header'、'footer'、'title'等 - 示例：
'body'
- 类型：
-
rotate：旋转角度
- 类型：
number - 取值范围：
-360–360（度） - 默认值：
0 - 示例：
180（旋转 180 度）
- 类型：
-
rounding：启用图片圆角
- 类型：
boolean - 默认值：
false
- 类型：
-
shadow：阴影
- 类型：
ShadowProps - 子参数：
- shadow.type：阴影类型
- 类型：
'outer' | 'inner' | 'none' - 默认值：
'none'
- 类型：
- shadow.opacity：不透明度
- 类型：
number - 取值范围：
0.0–1.0
- 类型：
- shadow.blur：模糊
- 类型：
number - 取值范围：
0–100（pt） - 默认值：
0
- 类型：
- shadow.angle：角度
- 类型：
number - 取值范围：
0–359（度） - 默认值：
0
- 类型：
- shadow.offset：偏移距离
- 类型：
number - 取值范围：
0–200（pt） - 默认值：
0
- 类型：
- shadow.color：阴影颜色
- 类型：
HexColor - 格式：6 位十六进制（无
#）
- 类型：
- shadow.rotateWithShape：阴影是否随形状旋转
- 类型：
boolean - 默认值：
false
- 类型：
- shadow.type：阴影类型
- 类型：
-
sizing：图片大小调整
- 类型：
{ type: 'contain' | 'cover' | 'crop', w: Coord, h: Coord, x?: Coord, y?: Coord } - 子参数：
- sizing.type：调整类型
- 类型：
'contain' | 'cover' | 'crop' - 取值范围：
contain— 包含（保持比例适配）cover— 覆盖（填充区域）crop— 裁剪
- 类型：
- sizing.w：图片宽度
- 类型：
Coord（英寸或百分比）
- 类型：
- sizing.h：图片高度
- 类型：
Coord（英寸或百分比）
- 类型：
- sizing.x：裁剪左偏移
- 类型：
Coord（仅用于crop模式）
- 类型：
- sizing.y：裁剪上偏移
- 类型：
Coord（仅用于crop模式）
- 类型：
- sizing.type：调整类型
- 类型：
-
transparency：透明度
- 类型：
number - 取值范围：
0–100（百分比） - 默认值：
0 - 示例：
25（25% 透明）
- 类型：
ShadowProps
用于 shadow 属性的类型定义（图表、图片、文字通用）。
-
type：阴影类型
- 类型：
'outer' | 'inner' | 'none' - 默认值：
'none'
- 类型：
-
opacity：不透明度
- 类型：
number - 取值范围：
0.0–1.0 - 示例：
0.5（50% 不透明）
- 类型：
-
blur：模糊大小
- 类型：
number - 取值范围：
0–100（pt） - 默认值：
0
- 类型：
-
angle：阴影角度
- 类型：
number - 取值范围：
0–359（度） - 默认值：
0
- 类型：
-
offset：阴影偏移距离
- 类型：
number - 取值范围：
0–200（pt） - 默认值：
0
- 类型：
-
color：阴影颜色
- 类型：
HexColor - 格式：6 位十六进制（无
#）
- 类型：
-
rotateWithShape：是否随形状旋转
- 类型：
boolean - 默认值：
false
- 类型：
HyperlinkProps
用于 hyperlink 属性的类型定义。
-
slide：链接到页码
- 类型：
number - 说明：跳转到演示文稿的指定幻灯片
- 类型：
-
url：超链接 URL
- 类型：
string - 说明：链接到外部网址
- 类型：
-
tooltip：超链接提示
- 类型：
string - 说明：鼠标悬停时显示的文字
- 类型：