简单易用
三个控件参数与两组功能函数构成核心 API，多数打印任务不到十行代码。
功能完整
HTML、表格、文本、图片、线条、条码、二维码、图表与 Excel 导出。
全浏览器
IE 内核使用控件，Chrome / Edge / Firefox 通过 C-Lodop 云打印，一套代码全覆盖。
布局可控
内置打印预览、打印维护、打印设计三套界面，既可由程序控制，也可交给用户调整。
快速开始 · 01
系统文件与安装
发布包由三个安装文件和一个引导脚本组成。建议页面综合部署：部分浏览器使用控件，其余通过云打印。
安装程序参数
可选| 参数 | 作用 | 示例 |
|---|---|---|
-waitXX | 安装 / 卸载完成后等待 XX 秒再关闭窗口，0 表示立即关闭 | -wait8 |
-nowindow | 静默运行，不显示安装界面 | -nowindow |
-un | 执行卸载操作，优先于文件名 | -un |
-in | 执行安装操作，优先于文件名 | -in |
控件与云打印如何选择？
由 LodopFuncs.js 中的 needCLodop() 根据浏览器 UA 自动判断。新版 Chromium 系列浏览器不再支持 NP 插件，会走 C-Lodop 云打印服务。
快速开始 · 02
三步开始打印
引入引导脚本 → 获取 LODOP 对象 → 初始化并添加打印项。以下代码可直接放入页面运行。
1
引入 LodopFuncs.js
把引导脚本作为统一的资源文件部署，所有页面共享一份，便于集中升级。
index.html
<script src="LodopFuncs.js"></script>
2
嵌入控件并获取对象
只保留 getLodop 一行，控件类型、安装检测与版本升级都交给引导脚本。
index.html
<object id="LODOP_OB" classid="clsid:2105C259-1E0C-4534-8141-A753534CB4CA" width="0" height="0">
<embed id="LODOP_EM" type="application/x-print-lodop" width="0" height="0">
</object>
<script>
var LODOP = getLodop(
document.getElementById('LODOP_OB'),
document.getElementById('LODOP_EM')
);
</script>
3
初始化、添加内容、预览
一个完整的打印事务：设置任务名和纸张 → 添加打印项 → 预览或打印。
print.js
// 1. 初始化（任务名可为空）
LODOP.PRINT_INIT("订单系统_销售单");
// 2. 设置纸张：A4 纵向
LODOP.SET_PRINT_PAGESIZE(1, 0, 0, "A4");
// 3. 添加打印项
LODOP.ADD_PRINT_TEXT(20, 20, 300, 28, "销售出库单");
LODOP.SET_PRINT_STYLEA(0, "FontSize", 18);
LODOP.SET_PRINT_STYLEA(0, "Bold", 1);
LODOP.ADD_PRINT_TABLE(80, 20, "100%", 300,
"<table border='1'><tr><td>商品</td><td>数量</td></tr>" +
"<tr><td>打印纸</td><td>2</td></tr></table>");
// 4. 预览或直接打印
LODOP.PREVIEW();
关于直接打印
PRINT()、PRINTA()、PRINTB() 与 Excel 导出属于注册功能；未注册时仍可使用，但输出左下角会出现“本页由【试用版打印控件】输出”的水印。
参考 · 控件参数
三个控件参数
以页面 object 元素的 param 形式使用。控件默认宽高为 0 时完全隐藏。
Caption显示标题
设置控件的显示标题。希望预览或设计界面内嵌到网页时，用它标识控件位置。
<param name="Caption" value="我是打印控件lodop">
Color区域颜色
设置控件显示区域的底色，支持 #十六进制、RGB 十进制或英文颜色名，便于融入页面。
<param name="Color" value="#C0C0C0">
Border区域边界
设置显示区域是否有边界。1 为有边界，其它值无边界。
<param name="Border" value="1">
嵌入示例：把预览界面内嵌进页面
<object id="LODOP_OB" classid="clsid:2105C259-1E0C-4534-8141-A753534CB4CA"
width="800" height="600">
<param name="Caption" value="打印预览">
<param name="Color" value="#f7f9fc">
<param name="Border" value="1">
<embed id="LODOP_EM" type="application/x-print-lodop" width="800" height="600">
</object>
进阶 · 高杠杆能力
别只逐项排版，这些函数更强
设计器、跨页表格、模板复用、文件导出、设备直写——6 组能力覆盖复杂打印场景。点击条目直接定位到对应函数并展开。
16 个增强型函数已在列表中标注
如 PRINT_INITA、ADD_PRINT_HTML、PREVIEWA、SAVE_TO_FILE，名称旁带「增强」徽标，也可一键筛选。
参考 · 函数库
API 参考
按用途浏览，或直接搜索函数名与中文说明。点击行展开参数、返回值与示例。
没有找到匹配的函数
试试更短的关键词，或切换到“全部”类别。
工具 · 可视化
排版沙盒
勾选元素，左侧纸张实时呈现，右侧同步生成对应的 LODOP 语句。用最直观的方式理解坐标与打印项。
纸张
打印元素
坐标单位默认是 px（1/96 英寸）。也可写成 "10mm"、"50%" 等带单位的值。
杭州云帆科技有限公司
销售出库单
| 商品名称 | 规格 | 数量 | 金额 |
|---|---|---|---|
| A4 打印纸 | 80g | 20 | 560.00 |
| 热敏标签纸 | 60×40 | 10 | 280.00 |
合计金额（大写）：捌佰肆拾元整￥840.00
收货人：__________审核：__________
财务专用章
A4 · 210 × 297 mm · 纵向
生成的代码
代码仅作演示，实际页面需先获取 LODOP 对象。
附录 · A
计量单位
所有位置与尺寸参数都支持整数（默认 px）或带单位的字符串。px 是固定换算单位，不受屏幕显示影响。
1 in
英寸
2.54 cm
1 in
英寸
25.4 mm
1 in
英寸
72 pt
1 in
英寸
96 px
书写规则
- 整数默认长度为
px；但SET_PRINT_PAGESIZE的宽高默认是0.1mm（45 表示 4.5mm）。 - 字符串可带
in、cm、mm、pt、px、%，如"10mm"。 - 百分比上下边距与高度相对纸张高度；左右边距与宽度相对纸张宽度（横向打印时互换）。
- 转义Width 可写
RightMargin:0.9cm，Height 可写BottomMargin:9mm，从纸张另一侧定位。
等价写法
LODOP.ADD_PRINT_TEXT(11, 23, 98, 19, "单位 px");
LODOP.ADD_PRINT_TEXT("2.9mm", "6.1mm", "25.9mm", "5mm", "单位 mm");
LODOP.ADD_PRINT_TEXT("5%", "3%", "40%", "10%", "百分比");
附录 · B
注册与维护
公开发行版没有功能限制，多数用户可以免费长期使用。仅少数功能需要注册。
免费
无需注册
- 打印预览与打印维护
- 全部打印项与样式设置
- 条码、二维码、图表
- 打印设计界面
需注册
商业功能
- 不经预览的直接打印
- 导出数据到 Excel
- 去除输出左下角试用水印
- 部分高级目录与网络功能
打印设计常用快捷键
面向开发者Ctrl选中多个对象
CtrlDelete删除选中对象
Ctrl方向键微调位置
Ctrl拖动复制对象
Alt拖动调整对象顺序
Ctrl滚轮区域内选中对象