Kaop打印项之线

线

功能说明

实现线的打印，支持线型、线宽等设置，详细参见属性列表。

属性列表

属性名	类型	默认值	说明
name	String	“”	打印项的名称，在打印任务内应该唯一。
label	String	“”	打印项的标题，打印设计或维护时， 可以更好的了解打印项代表的含义。
x	String	0	起点水平相对打印区域的位置，默认单位毫米(mm)， 可用单位: 毫米 - mm，如：“10mm” 厘米 - cm，如：“1cm” 点 - pt，如：“16pt” 英寸 - in，如：“1in” 派卡 - pc，如：“2pc” 像素 - px，如：“10px” 单位换算关系: 1in = 2.54cm = 25.4 mm = 72pt = 6pc=96px， 同时支持百分比，如：“20%”,表示占父容器可 用宽度的20%的位置。
y	String	0	起点垂直相对打印区域的位置，默认单位毫米(mm), 支持单位及单位换算参见"x"属性，同时支持百分比， 如：“20%”,表示占父容器可用高度的20%的位置。
endX	String	null	终点水平相对打印区域的位置，默认单位毫米(mm), 支持单位及单位换算参见"x"属性，同时支持百分比， 如：“20%”,表示占父容器可用宽度的20%。
endY	String	null	终点垂直相对打印区域的位置，默认单位毫米(mm), 支持单位及单位换算参见"x"属性，同时支持百分比， 如：“20%”,表示占父容器可用高度的20%。
zindex	Integer	0	打印项所在图层，图层数值大的打印项会遮挡 图层数值小的打印项。
lineWidth	String	“0.5pt”	线宽，默认单位毫米(mm)，支持单位及单位换算参见"x"属性
lineDash	String	null	线型，默认null表示实线，线型有效值如下： solid - 实线 dotted - 点线 dashed - 虚线 dot-dash - 点划线 double-dot-dash - 双点划线 自定义 -线型由 “线+缺口+线+缺口+线+缺口……” 组成，如：“6pt 3pt”。
lineColor	String	null	线颜色，支持CSS中颜色定义规范,如： “#fff”, “#f2f2f2”, “rgb(255,255,0)”, “rgba(255,255,0,125)”
margin	String	null	外边距，类似CSS中margin，如： "1pt 2pt 3pt 4pt"表示上右下左的外边距 分别为1pt、2pt、3pt、4pt；
hRelativeTo	String	null	水平位置相对于，可选值为: 相对于前面的打印项 - pre 线对于指定打印项 - #+打印项名称，如：“#text1”
vRelativeTo	String	null	垂直位置相对于，可选值为: 相对于前面的打印项 - pre 线对于指定打印项 - #+打印项名称，如：“#text1”
fixed	Boolean	false	是否在每页重复出现，当设置为true时，该打印项会出现在每页的相应位置，可以实现诸如水印等特殊业务场景。

示例代码

//create print job
var job = Kaop.createPrintJob("Line Demo Print Job");

//pages
//the page 0
job.addLine("线_1","27.169","33.073","182.833","33.073");
job.addLine("线_2","27.346","50.58","183.01","50.58");
job.setItemAttr("线_2","lineWidth","1.5pt");
job.setItemAttr("线_2","lineDash","dashed");
job.addLine("线_3","27.169","68.704","182.833","68.704");
job.setItemAttr("线_3","lineWidth","4.5pt");
job.setItemAttr("线_3","lineDash","double-dot-dash");

//actions
job.preview();

预览效果