您现在的位置: 恒佑条码 >> 新闻资讯 >> 新闻资讯 >> 产品发布 >> 正文
产品发布
Label mx 9.1 SDK二次开发函数接口使用说明
2020/7/30 10:49:21

外部程序通过《Label mx 通用条码标签设计系统》开放的函数接口,传递变量数据来修改标签文件里的条码、文字等内容,快速开发出带有条码标签打印功能的程序。

SDK实现的原理:

1、用Label mx 通用版设计好标签模板文件*.lax

2、外部程序通过开放的函数接口,传递变量数据来修改模板文件里的条码、文字内容。

3、打印的过程中不弹出Label mx的设计环境。

SDK授权模式:

    一、SDK为独立的DLL文件;

    二、支持语言:VB、VB.NET、C++C#、Java、易语言Delphi等;

    三、支持架构:C/S程序最后编译程序需EXE

    四、SDK一次授权终身免费使用和免费同步升级;

    五、授权绑定的程序不需要注册授权用户端免费使用;   

SDK函数列表:

HY_Initialization

HY_Close

HY_OpenLax

HY_SaveLax

HY_GetSize_w

HY_GetSize_h

HY_SetSize

HY_GetTop

HY_SetTop

HY_GetLeft
HY_SetLeft

HY_SetVariable

HY_SetVariable2

HY_SetVariable_Array

HY_SetDataSource_TXT

HY_SetDataSource_Excel

HY_SetDataSource_Access

HY_SetDataSource_Sqlite

HY_SetDataSource_SQLServer

HY_SetDataSource_MySQL

HY_SetDataSource_DBF

HY_SetDataSource_Oracle

HY_SetTrim

HY_Print , HY_PrintEx

HY_PrintSet

HY_PrintPic

HY_Pic_bin

HY_Pic_FreeMen

HY_GetRGB

HY_SetColorTXT

HY_SetColor1D

HY_SetColor2D

HY_SetBarcodeErrCheck

HY_GetRunDir

HY_GetRunName

HY_RegBarcode ,HY_IsReg

HY_MsgBoxC

HY_SetErrTip

HY_GetVariableName

HY_GetPicData

HY_SerPicDisplay

HY_IsPrinting

 

 

 

函数执行过程

 

举例:

HY_Initialization (0) //只运行一次

HY_OpenLax (“demo.lax”)

HY_SetVariable (“barcode”, “6901234567892”, “”, “”)

HY_SetVariable (“T文字2”, “20181018001”, “批号:”, “”)

HY_Print (-2, “-1”, truefalse)

//上面代码可以反复使用

HY_Close()//只运行一次

注意:1.如果文字、条码设置了流水号属性,每次传递的是起始值

      2.图片变量传递的是“图片路径”

      3.不传递变量的图形按本身属性打印

4.为了函数传递参数方便,可以给图形设置别名,具体方法:菜单“图层”-“设置图层别名”,或按下快捷键F10如果多个图形设置相同的别名,可以实现批量传值修改

 

 

 

 

 

 

 

 

 

 

 

 

函数详细说明

函数名称

int HY_Initialization (int Language)

函数说明

说明:初始化函数,返回 0成功,-1失败

参数:Language 为 显示语言 (0=简体中文,1=繁体)

注意:本函数只在整个项目程序“开始”的时候运行1次不能多次使用

函数名称

void HY_Close()

函数说明

说明:关闭函数

注意:本函数只在整个项目程序“结束”的时候运行1次,不能多次使用

注意:如果没有进行HY_Initialization()初始化工作,以下的函数调用会出错。

 

函数名称

bool HY_OpenLax(string lax_files)

函数说明

说明:打开标签模板文件

参数:lax_file 为Label mx设计保存的标签文件,默认后缀lax,如:"d:\test\123.lax"

函数名称

bool HY_SaveLax(string lax_files)

函数说明

说明:保存标签模板文件

参数:lax_file 为保存文件名如果给“”空路径,则覆盖保存原打开的文件

 

函数名称

double HY_GetSize_w()

函数说明

说明:获取标签模板文件的宽度属性(mm毫米单位)

参数:

函数名称

double HY_GetSize_h()

函数说明

说明获取标签模板文件的高度属性(mm毫米单位)

参数:

函数名称

void HY_SetSize(double Size_w, double Size_h)

函数说明

说明:设置标签模板文件的宽度、高度属性

参数:Size_w 为标签宽度值,Size_h 为标签高度值(mm毫米单位)

函数名称

double HY_GetTop(string PicName)

函数说明

说明:获取 图形的边坐标//0.01mm单位

参数:PicName 为标签文件里对应的图形名称,可以使用别名

函数名称

bool  HY_SetTop(string PicName, double TopY)

函数说明

说明:修改 图形的边坐标

参数:PicName 为标签文件里对应的图形名称,可以使用别名

参数:TopY 顶边值 //0.01mm单位,举例11.85mm传入值是1185

 

函数名称

double HY_GetLeft(string PicName)  

函数说明

说明:获取 图形的边坐标 //0.01mm单位

参数:PicName 为标签文件里对应的图形名称,可以使用别名

函数名称

bool  HY_SetLeft(string PicName, double LeftX)

函数说明

说明:修改 图形的边坐标

参数:PicName 为标签文件里对应的图形名称,可以使用别名

参数:LeftX 左边值 //0.01mm单位,举例11.85mm传入值是1185

 

函数名称

string  HY_GetVariableName()  

函数说明

说明:获取图形的全部图层名

格式图层名:别名;图层名:null    外部使用自行分割(冒号和分号),null代表没有别名

 

函数名称

int  HY_SerPicDisplay(string PicName,bool Cbool)  

函数说明

说明:设置图形的可视状态,成功返回0,失败返回-1代表PicName无效

参数:Cbool 是否可视 true为显示,false为不显示

 

函数名称

string  HY_GetPicData(string PicName)  

函数说明

说明:获取图形的默认值,返回“Error”代表PicName无效

参数:PicName 为标签文件里对应的图形名称,可以使用别名

 

函数名称

bool  HY_SetVariable(string PicName, string Variable_data, string

FirstData, string EndData) 

函数说明

说明:设置图形变量数据,注意:传递数据不改变原“存在方式”,如连接了数据库,即使传递了数据,打印还是读取数据库;而“流水号”方式传递数据是修改起始号码

参数:PicName 为标签文件里对应的图形名称,可以使用别名

参数:Variable_data 传递的变量数据内容;如果传递参数为“\NOP”,则表示打印原标签数据;如果传递参数为“\DEL”,则表示原标签数据跳过为不打印

参数:FirstData 附加字符的首部内容,文字和条码有效且勾选了“附加字符”属性

参数:EndData 附加字符的尾部内容,文字和条码有效且勾选了“附加字符”属性

实例:HY_SetVariable (“T文字1”, “2013001”, “a”, “c”)

      HY_SetVariable (“test”, “2013001”, “”, “”) // test为别名

      HY_SetVariable (“barcode”, “\DEL”, “”, “”) // barcode为别名

 

函数名称

bool  HY_SetVariable2(string PicName, string Variable_data, string

FirstData, string EndData, int Fcolor_R, int Fcolor_G, int Fcolor_B,

int Bcolor_R, int Bcolor_G, int Bcolor_B) 

函数说明

说明:设置图形变量数据,和HY_SetVariable的区别是多了前景背景色参数

参数:PicName 为标签文件里对应的图形名称,可以使用别名

参数:Variable_data 传递的变量数据内容;如果传递参数为“\NOP”,则表示打印原标签数据;如果传递参数为“\DEL”,则表示原标签数据跳过为不打印

参数:FirstData 附加字符的首部内容,文字和条码有效且勾选了“附加字符”属性

参数:EndData 附加字符的尾部内容,文字和条码有效且勾选了“附加字符”属性

参数:Fcolor_R, Fcolor_G, Fcolor_B 为前景色颜色,Bcolor_R, Bcolor_G, Bcolor_B为背景色颜色,传递-1不修改颜色

实例:HY_SetVariable2 (“T文字1”,“2013001”,“a”,“c”-1-1-1-1-1-1)

      HY_SetVariable2 (“test”,“2013001”, “”,“”, -1-1-1-1-1-1) // test为别名

      HY_SetVariable2 (“barcode”, “\DEL”, “”, “”) // barcode为别名

HY_SetVariable2 (“test”,“2013001”, “”,“”, 1005050808080)

 

函数名称

int  HY_SetVariable_Array(string DataTxtArray)  

函数说明

说明:设置变量数据组一次性传递多个标签数据,返回值0失败大于0 是标签

参数:DataTxtArray传递的数据文本组格式说明如下:

      图层名1{d}数据1 {n} 图层名2{d}数据2 {n} {#}

      {d} 图层名和数据 分割符

      {n} 同一个标签的多个数据 分割符

      {#} 多个标签 分隔符

       \DEL 不打印

举例:HY_SetVariable_Array (“txt1{d}恒佑科技{n}txt2{d}00001{n}barcode{d}

6901234567892{#}txt1{d}恒佑条码{n}txt2{d}00002{n}barcode{d}\DEL”)

 

函数名称

bool  HY_SetDataSource_TXT (string PicName, string TxtFiles, string

DataRange) 

函数说明

说明:设置数据源TXT的连接参数

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:TxtFiles 文件路径,给空表示不修改

参数:DataRange记录范围“”为全部记录;“12-100”第几条到第几条

函数名称

bool  HY_SetDataSource_Excel (string PicName, string ExcelFiles, string DataRange)

函数说明

说明:设置数据源Excel文件的连接参数

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:ExcelFiles 文件路径,给空表示不修改

参数:DataRange记录范围“”为全部记录;“12-100”第几条到第几条;“sql|SQL语句如: “sql|select * from [sheet1$] where ID=1001”

 

函数名称

bool  HY_SetDataSource_Access (string PicName, string MDBFiles, string

 MDBPassword, string DataRange)

函数说明

说明:设置数据源Access文件的连接参数

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:MDBFiles 数据库文件路径,给空表示不修改

参数:MDBPassword 数据库密码,给空表示不修改

参数:DataRange记录范围“”为全部记录;“12-100”第几条到第几条;“sql|SQL语句如: “sql|select * from table1 where ID=1001”

函数名称

bool  HY_SetDataSource_Sqlite (string PicName, string  SqliteFiles, string

DataRange)

函数说明

说明:设置数据源Sqlite的连接参数

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:SqliteFiles 数据库文件路径,给空表示不修改

参数:DataRange记录范围“”为全部记录;“12-100”第几条到第几条;“sql|SQL语句如: “sql|select * from SqliteFiles where ID=1001”

 

函数名称

bool  HY_SetDataSource_SQLServer(string PicName, string IP, string

 Database, string Username, string Password, string DataRange)

函数说明

说明:设置数据源SQLServer的连接参数

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:IP 数据库的服务器地址,给空表示不修改

参数:Database 数据库名称,给空表示不修改

参数:Username 用户名,给空表示不修改

参数:Password 密码,给空表示不修改

参数:DataRange记录范围“”为全部记录;“12-100”第几条到第几条;“sql|SQL语句如: “sql|select * from table1 where ID=1001”

 

函数名称

bool  HY_SetDataSource_Oracle (string PicName,int DataVerstring IP,

string Database, string Username, string Password, string DataRange)

函数说明

说明:设置数据源Oracle的连接参数

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:DataVer 数据库版本,给空表示不修改;0= 8.051= 8i2= 9i3=10g4=11g

参数:IP 数据库的服务器地址,给空表示不修改

参数:Database 数据库名称,给空表示不修改

参数:Username 用户名,给空表示不修改

参数:Password 密码,给空表示不修改

参数:DataRange记录范围“”为全部记录;“12-100”第几条到第几条;“sql|SQL语句如: “sql|select * from table1 where ID=1001”

   

函数名称

bool  HY_SetDataSource_MySQL (string PicName, string IP, string

 Username, string Password, string Database, string Rort, string DataRange)

函数说明

说明:设置数据源MySQL的连接参数

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:IP 数据库的服务器地址,给空表示不修改

参数:Username 用户名,给空表示不修改

参数:Password 密码,给空表示不修改

参数:Database 数据库名称,给空表示不修改

参数:Rort 端口号,给空表示不修改

参数:DataRange记录范围“”为全部记录;“12-100”第几条到第几条;“sql|SQL语句如: “sql|select * from table1 where ID=1001”

 

函数名称

bool  HY_SetDataSource_DBF (string PicName, string DbFiles, int iDrive, string DataRange)

函数说明

说明:设置数据源Access文件的连接参数

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:DbFiles数据库文件路径,给空表示不修改

参数:iDrive连接驱动传值 0~5,六个连接驱动文本

参数:DataRange记录范围“”为全部记录;“12-100”第几条到第几条;“sql|SQL语句如: “sql|select * from table1 where ID=1001”

 

函数名称

void  HY_SetTrim(int Mode

函数说明

说明:数据库记录空格的处理方式, 只对文本、条码读取数据库时有效

参数:Mode 处理方式0=不处理1=删首空2=删尾空3=删首尾空4=删全部空

   

函数名称

int  HY_Print(int PrintSetup, string PrinterName, bool PageWindowsShow, bool PringWinShow)

函数说明

说明:打印函数成功 返回 0,打印错误或打印中止返回 -1

参数:PrintSetup打印设置 可为 0

参数:PrinterName打印机名 可为“”

参数:PageWindowsShow 是否显示页面范围设置窗口 true为显示,false为不显示

参数:PringWinShow 是否显示打印进度状态窗口 true为显示,false为不显示

-----------------------------------------------------------------------------------------

详细说明:

PrintSetup   值范围(0、-1、-2、-3、-4、大于0的整数页数

0   默认标签文件的打印设置和打印数量(如果连接了数据库,打印数量设置无效,为数据库连接的数量)

-1   默认标签文件的打印设置,打印1个标签。

-2   弹出“打印设置”窗口。

-3   弹出“打印预览”窗口。

-4   弹出“打印预览”窗口,禁止预览窗口上的打印设置按钮

大于0的整数   设置打印数量。

PrinterName   值范围(“”、“-1”、“-2”、“打印机名称”)

""或"-1"   弹出选择打印机窗口

"-2"   不弹出选择打印机窗口,采用默认打印机打印

"打印机名"   打印到指定的打印机,如“TSC 243E”。

PageWindowsShow   是否显示页面范围设置窗口 true为显示,false不显示(下左图)

PringWinShow   是否显示打印进度状态窗口 true为显示,false不显示(下右图)

 

 页面范围

 

 打印进度

 

 

函数名称

bool  HY_IsPrinting(

函数说明

说明:返回打印函数HY_Print的打印状态, true正在打印false空闲状态,建议打开模板文件HY_OpenLax之前判断一下(任何操作数据或打印函数之前都可以判断)。

 

 

函数名称

int HY_PrintEx(int PrintSetup, string PrinterName, string PageNumber, bool PringWinShow)

函数说明

说明:打印函数成功 返回 0,打印错误或打印中止返回 -1

参数:PrintSetup打印设置 可为 0

参数:PrinterName打印机名 可为“”

参数:PageNumber不能为空“”和“0”值;“-1”表示全部页码。页码范围分割符为逗号,"-"代表多少到多少页(如:1,3,5-12)

参数:PringWinShow 是否显示打印进度状态窗口 true为显示,false为不显示

-----------------------------------------------------------------------------------------

详细说明:

PrintSetup   值范围(0、-1、-2、-3、-4、大于0的整数页数

0   默认标签文件的打印设置和打印数量(如果连接了数据库,打印数量设置无效,为数据库连接的数量)

-1   默认标签文件的打印设置,打印1个标签。

-2   弹出“打印设置”窗口。

-3   弹出“打印预览”窗口。

-4   弹出“打印预览”窗口,禁止预览窗口上的打印设置按钮

大于0的整数   设置打印数量。

PrinterName   值范围(“”、“-1”、“-2”、“打印机名称”)

""或"-1"   弹出选择打印机窗口

"-2"   不弹出选择打印机窗口,采用默认打印机打印

"打印机名"   打印到指定的打印机,如“TSC 243E”。

PageNumber   传递打印页面范围 不能为空和“0”值(如:1,3,5-12)

PringWinShow   是否显示打印进度状态窗口 true为显示,false不显示

 

 

函数名称

void  HY_PrintSet(double PageLeft, double PageTop, double Spacing_Hdouble Spacing_V, int SingleCopy, int StartPosition, int Orientation, int Quantity)

函数说明

说明:打印设置;打印函数HY_Print之前操作

参数:PageLeft       页面左边留空距离,-1024表示默认不改mm单位

参数:PageTop       页面顶边留空距离,-1024表示默认不改mm单位

参数:Spacing_H     单个标签的水平距离,-1024表示默认不改mm单位

参数:Spacing_V     单个标签的垂直距离,-1024表示默认不改mm单位

参数:SingleCopy    单条复制份数,1或-1024表示默认不改

参数:StartPosition   打印起始位置,1或-1024表示默认不改

参数:Orientation    打印排列方向,0是横向 1是纵向,-1024表示默认不改

参数:Quantity       标签数量,-1024表示默认不改

函数名称

int  HY_PrintPic(string Out_directory,string Out_FirstName, int Out_DPI_Hint Out_DPI_V, int Out_Color, bool Out_LenAlign)

函数说明

说明:打印到图片;成功返回生成的图片数量,失败返回 -1。

参数:Out_directory 输出目录

参数:Out_FirstName 输出文件名前缀,可为空“”

参数:Out_DPI_H 输出的横向分辨率

参数:Out_DPI_V 输出的纵向分辨率

参数:Out_Color 输出位深度(1、4、8、24、32)

参数Out_LenAlign 文件名长度是否对齐,true对齐false对齐

 

函数名称

int  HY_Pic_bin(int* Out_bin, int Out_DPI_H, int Out_DPI_V, int Out_Color, int Out_RecNO)

函数说明

说明:生成内存图片;成功返回内存长度,开发者通过内存地址和长度读取图片数据;失败返回 -1。

参数:Out_bin 内存地址指针;

参数:Out_DPI_H 输出的横向分辨率

参数:Out_DPI_V 输出的纵向分辨率

参数:Out_Color 输出位深度(1、4、8、24、32)

参数Out_RecNO 记录号,1为第一个标签图片,2为第二个......

函数名称

void  HY_Pic_FreeMen (int Out_bin)

函数说明

说明:释放图片内存

参数:Out_bin 内存地址, HY_Pic_bin 生成的地址每次生成后都要释放,切记

函数名称

Int  HY_GetRGB (int R, int G, int B)

函数说明

说明:返回计算RGB颜色值

参数:R 红;G 绿;B 蓝(取值范围0~255)

 

函数名称

void  HY_SetColorTXT (string PicName,bool Color_Enable, int

Color_Mode,  string Color_Style,  string Color_Group)

函数说明

说明:设置文本彩码

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:Color_Enable 是否启用彩码功能,true 启用, false 不启用

参数:Color_Mode 颜色排列, 0顺序,1随机,2系统随机

参数:Color_Style 字符范围, -65535 全部 ,2-5是字符范围(第2到第5个字符)

参数:Color_Group 颜色值组,逗号分隔的颜色值,可以用HY_GetRGB计算

函数名称

void  HY_SetColor1D (string PicName,  bool Color_Enableint

Color_Mode, string Color_Style, string Color_Group)

函数说明

说明:设置一维码色字符

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:Color_Enable 是否启用彩码功能,true 启用, false 不启用

参数:Color_Mode 颜色排列, 0顺序,1随机,2系统随机

参数:Color_Style 字符范围, -65535 全部 ,2-5是字符范围(第2到第5个字符)

参数:Color_Group 颜色值组,逗号分隔的颜色值,可以用HY_GetRGB计算

函数名称

void  HY_SetColor2D (string PicName,  bool Color_Enableint

Color_Mode, string Color_Style, string Color_Group)

函数说明

说明:设置二维码QRCODE彩码

参数:PicName 为标签文件里对应的“数据源”名称,可以使用别名

参数:Color_Enable 是否启用彩码功能,true 启用, false 不启用

参数:Color_Mode 颜色排列, 0顺序,1随机,2系统随机

参数:Color_Style 样式值,二维码是1-8个样式值

参数:Color_Group 颜色值组,逗号分隔的颜色值,可以用HY_GetRGB计算

其他函数:

函数名称

void  HY_SetBarcodeErrCheck (bool Check)

函数说明

说明:设置条码是否关闭错误校正窗口默认false即发现条码错误会提示

参数:Check 是否关闭true 关闭提示,关闭后发现校验码错误会自动修复,发现长度或格式不对打印空白并跳过去继续打印

 

函数名称

void  HY_SetErrTip (bool Enable)

函数说明

说明:设置是否关闭程序的错误提示框

参数:Enable 是否关闭,真 true 不提示,false 假 提示,推荐开发的时候设置提示,发布的时候设置不提示

函数名称

string  GetRunDir ()

函数说明

说明:取运行目录

参数:返回 DLL文件运行的目录,尾部不带“\”,如:“d:\Pub\system”

函数名称

string  HY_GetRunName ()

函数说明

说明:取DLL全路径文件名如:c:\Labelmx_sdk.dll

参数:

函数名称

void  HY_RegBarcode ()

函数说明

说明:弹出注册申请窗口,用于特定接口版用户的单机授权注册申请

参数:

函数名称

bool  HY_IsReg ()

函数说明

说明:检查DLL是否绑定授权,真 true 已授权,false 假 未授权

参数:

函数名称

void  HY_MsgBoxC (string Caption)

函数说明

说明:设置提示框的标题默认是“Label mx”

参数:Caption 标题文本,比如改成开发的程序标题:“XX证卡打印系统”

 

  • 上一篇新闻:

  • 下一篇新闻:
  • 关于我们
    公司简介
    新闻资讯
    公司新闻
    产品发布
    市场动态
    行业新闻
    展会信息
    条码软件
    物品编码中心
    条码标准文献
    Label mx 大事记
    恒佑科技(条码软件-条形码软件 -标签打印软件-二维码软件 -条码打印软件) 版权所有(2003-2019) HengYou Technology Co.,Ltd
    公司地址:河南省郑州市高新区正弘高新数码港17楼947室 邮政编码:450001
    服务热线:0371-67998681 67998108 传真:0371-67998682 节假日:17603877538
    豫ICP备11004848号 网站备案号

    豫公网安备41019702002059号

    公司简介 | 人才招聘 | 友情链接 | 条码软件 | 网站地图 | 豫ICP备11004848号