Skip to content

图片操作相关方法

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支持的图片格式

注意事项

  1. 文件路径:本地文件路径必须是完整路径,支持相对路径和绝对路径
  2. 网络图片:URL必须返回有效的图片文件,建议使用HTTPS协议
  3. 图片大小:建议控制图片大小,过大的图片可能影响性能
  4. 浮动图片:浮动图片可以精确定位,内嵌图片跟随文本流
  5. OCR功能:OCR识别需要图片清晰,文字部分不能过于模糊
  6. 透明背景:IsTransBackground参数对PNG等支持透明的格式有效
  7. 缩放比例:scale参数以百分比计算,100表示原始大小
  8. 定位精度:left和top参数以磅为单位,1磅约等于1/72英寸
  9. 层级关系:zorder参数控制图片与文字的层级关系
  10. 批量操作:AddMultiPicFromLocal会弹出系统文件选择对话框