Appearance
图片操作相关方法
AddPicFromLocal
语法
javascript
AddPicFromLocal(Filename, [PromptSelect], [IsFloat], [left], [top], [relative], [scale], [zorder], [IsDoOCR], [IsTransBackground])
功能
用来从本地增加图片到Office文档。
参数
名称 | 必选/可选 | 数据类型 | 说明 |
---|---|---|---|
Filename | 必选 | string | 本地图片文件路径 |
PromptSelect | 可选 | bool | 是否允许用户选择文件,缺省是true,允许选择 |
IsFloat | 可选 | bool | 是否浮动图片,缺省是true,代表浮动 |
left | 可选 | long | 插入图片的左边距 |
top | 可选 | long | 插入图片的上边距 |
relative | 可选 | long | 图片定位模式 |
scale | 可选 | long | 图片缩放值,默认100无缩放 |
zorder | 可选 | long | 图片相对文字位置 |
IsDoOCR | 可选 | bool | 是否识别图片文件 |
IsTransBackground | 可选 | bool | 白色背景是否透明,默认false |
返回值
无返回值。
说明
该函数用来从本地增加图片到Office文档。
参数详细说明
- Filename:本地图片文件的完整路径
- PromptSelect:是否弹出文件选择对话框让用户选择文件
- IsFloat:是否作为浮动图片插入,true为浮动,false为内嵌
- left:缺省值是0;如果IsFloat为false,则在当前光标处插入。该参数不起作用。如果IsFloat为true,则指明插入的图片相对于当前段落左栏的位置,以磅为单位。
- top:缺省值是0;如果IsFloat为false,则在当前光标处插入。该参数不起作用。如果IsFloat为true,则指明插入的图片相对于当前段落顶部的位置,以磅为单位。
- relative:取值1-4。1:光标位置;2:页边距;3:页面距离 4:默认设置栏,段落(为兼容以前版本默认方式)。
- scale:图片缩放百分比,100表示原始大小
- zorder:表示图片是置于文字的上方还是下方。0:下方;1:上方。
- IsDoOCR:是否对图片进行OCR文字识别
- IsTransBackground:是否将白色背景设为透明
示例代码
javascript
// 基本用法 - 从本地文件添加图片
OCX_OBJ.AddPicFromLocal("C:\\images\\photo.jpg");
// 完整参数示例
OCX_OBJ.AddPicFromLocal(
"C:\\images\\photo.jpg", // 路径
true, // 是否提示选择文件
true, // 是否浮动图片
0, // 如果是浮动图片,相对于左边的Left 单位磅
0, // 如果是浮动图片,相对于当前段落Top
1, // 当前光标处
100, // 无缩放
1 // 文字上方
);
// 内嵌图片(非浮动)
OCX_OBJ.AddPicFromLocal("C:\\images\\logo.png", false, false);
// 带OCR识别的图片
OCX_OBJ.AddPicFromLocal("C:\\images\\document.jpg", true, true, 0, 0, 1, 100, 1, true, false);
AddPicFromURL
语法
javascript
AddPicFromURL(URL, [IsFloat], [left], [top], [relative], [scale], [zorder], [IsDoOCR], [IsTransBackground])
功能
用来从URL增加图片到Office文档。
参数
名称 | 必选/可选 | 数据类型 | 说明 |
---|---|---|---|
URL | 必选 | string | 图片URL地址 |
IsFloat | 可选 | bool | 是否浮动图片,缺省是true,代表浮动 |
left | 可选 | long | 插入图片的左边距 |
top | 可选 | long | 插入图片的上边距 |
relative | 可选 | long | 图片定位模式 |
scale | 可选 | long | 图片缩放值,默认100无缩放 |
zorder | 可选 | long | 图片相对文字位置 |
IsDoOCR | 可选 | bool | 是否识别图片文件 |
IsTransBackground | 可选 | bool | 白色背景是否透明,默认false |
返回值
无返回值。
说明
该函数用来从URL增加图片到Office文档。
参数详细说明
- URL:该URL返回的必须是Office支持的文件类型(如JPG、PNG、GIF、BMP等)
- left:缺省值是0;如果IsFloat为false,则在当前光标处插入。该参数不起作用。如果IsFloat为true,则指明插入的图片相对于当前段落左栏的位置,以磅为单位。
- top:缺省值是0;如果IsFloat为false,则在当前光标处插入。该参数不起作用。如果IsFloat为true,则指明插入的图片相对于当前段落顶部的位置,以磅为单位。
- relative:取值1-4。1:光标位置;2:页边距;3:页面距离 4:默认设置栏,段落(为兼容以前版本默认方式)。
- scale:图片缩放百分比,100表示原始大小
- zorder:表示图片是置于文字的上方还是下方。0:下方;1:上方。
- IsDoOCR:是否对图片进行OCR文字识别
- IsTransBackground:是否将白色背景设为透明
示例代码
javascript
// 基本用法 - 从URL添加图片
OCX_OBJ.AddPicFromURL("https://example.com/image.jpg");
// 完整参数示例
OCX_OBJ.AddPicFromURL(
"https://example.com/image.jpg", // URL 注意:URL必须返回Word支持的图片类型
true, // 是否浮动图片
0, // 如果是浮动图片,相对于左边的Left 单位磅
0, // 如果是浮动图片,相对于当前段落Top
1, // 当前光标处
100, // 无缩放
1 // 文字上方
);
// 内嵌图片(非浮动)
OCX_OBJ.AddPicFromURL("https://example.com/logo.png", false);
// 缩放图片
OCX_OBJ.AddPicFromURL("https://example.com/photo.jpg", true, 0, 0, 1, 50, 1); // 50%缩放
// 带OCR识别的网络图片
OCX_OBJ.AddPicFromURL("https://example.com/document.jpg", true, 0, 0, 1, 100, 1, true, false);
AddMultiPicFromLocal
语法
javascript
AddMultiPicFromLocal()
功能
从本地插入多张图片。
参数
无参数。
返回值
无返回值。
说明
从本地插入多张图片。方法执行后,会弹出文件对话框供用户选择。
示例代码
javascript
// 弹出文件选择对话框,允许用户选择多张图片
OCX_OBJ.AddMultiPicFromLocal();
完整示例
javascript
// 图片操作完整示例
function imageOperationsDemo() {
// 1. 添加本地图片
function addLocalImages() {
// 添加浮动图片
OCX_OBJ.AddPicFromLocal("C:\\images\\banner.jpg", false, true, 100, 50, 1, 80, 1);
// 添加内嵌图片
OCX_OBJ.AddPicFromLocal("C:\\images\\logo.png", false, false);
// 添加带OCR的图片
OCX_OBJ.AddPicFromLocal("C:\\images\\scanned.jpg", false, true, 0, 0, 1, 100, 1, true, true);
}
// 2. 添加网络图片
function addNetworkImages() {
// 添加网络图片
OCX_OBJ.AddPicFromURL("https://example.com/header.jpg", true, 0, 0, 1, 100, 1);
// 添加缩放的网络图片
OCX_OBJ.AddPicFromURL("https://example.com/thumbnail.jpg", true, 200, 100, 1, 50, 1);
}
// 3. 批量添加图片
function addMultipleImages() {
// 弹出文件选择对话框
OCX_OBJ.AddMultiPicFromLocal();
}
// 4. 不同定位模式的图片
function addPositionedImages() {
// 光标位置
OCX_OBJ.AddPicFromLocal("C:\\images\\pic1.jpg", false, true, 0, 0, 1, 100, 1);
// 页边距定位
OCX_OBJ.AddPicFromLocal("C:\\images\\pic2.jpg", false, true, 0, 0, 2, 100, 1);
// 页面距离定位
OCX_OBJ.AddPicFromLocal("C:\\images\\pic3.jpg", false, true, 0, 0, 3, 100, 1);
// 默认设置
OCX_OBJ.AddPicFromLocal("C:\\images\\pic4.jpg", false, true, 0, 0, 4, 100, 1);
}
// 5. 不同层级的图片
function addLayeredImages() {
// 图片在文字下方
OCX_OBJ.AddPicFromLocal("C:\\images\\background.jpg", false, true, 0, 0, 1, 100, 0);
// 图片在文字上方
OCX_OBJ.AddPicFromLocal("C:\\images\\watermark.png", false, true, 0, 0, 1, 100, 1);
}
}
// 图片处理工具函数
function imageUtils() {
// 添加水印图片
function addWatermark(imagePath) {
OCX_OBJ.AddPicFromLocal(imagePath, false, true, 0, 0, 1, 30, 1, false, true);
}
// 添加背景图片
function addBackground(imagePath) {
OCX_OBJ.AddPicFromLocal(imagePath, false, true, 0, 0, 1, 100, 0);
}
// 添加缩略图
function addThumbnail(imagePath, size) {
OCX_OBJ.AddPicFromLocal(imagePath, false, true, 0, 0, 1, size, 1);
}
// 添加OCR图片
function addOCRImage(imagePath) {
OCX_OBJ.AddPicFromLocal(imagePath, false, true, 0, 0, 1, 100, 1, true, false);
}
}
参数对照表
relative 参数取值
值 | 说明 |
---|---|
1 | 光标位置 |
2 | 页边距 |
3 | 页面距离 |
4 | 默认设置栏,段落(为兼容以前版本默认方式) |
zorder 参数取值
值 | 说明 |
---|---|
0 | 图片在文字下方 |
1 | 图片在文字上方 |
支持的图片格式
- 本地文件:JPG、PNG、GIF、BMP、TIFF、WMF、EMF等
- 网络URL:必须返回Office支持的图片格式
注意事项
- 文件路径:本地文件路径必须是完整路径,支持相对路径和绝对路径
- 网络图片:URL必须返回有效的图片文件,建议使用HTTPS协议
- 图片大小:建议控制图片大小,过大的图片可能影响性能
- 浮动图片:浮动图片可以精确定位,内嵌图片跟随文本流
- OCR功能:OCR识别需要图片清晰,文字部分不能过于模糊
- 透明背景:IsTransBackground参数对PNG等支持透明的格式有效
- 缩放比例:scale参数以百分比计算,100表示原始大小
- 定位精度:left和top参数以磅为单位,1磅约等于1/72英寸
- 层级关系:zorder参数控制图片与文字的层级关系
- 批量操作:AddMultiPicFromLocal会弹出系统文件选择对话框