﻿=====================================================================================
LabelShop Api 开发接口
为了让用户在自己的系统中可以集成使用 LabelShop 强大标签编辑打印功能，LabelShop 提供了 Api 开发接口。Api 以标准的DLL模式提供，同时提供可供C++、C#等开发环境使用的接口定义。使用 Api 打印标签模板，需要预先使用LabelShop编辑并保存标签模板，然后通过 Api 打开保存的模板，并通过对标签模板上对象的内容进行设置，然后打印标签。Api 还提供了标签模板略图、打印机设置等功能。 

Api 提供的功能
LabelShop Api 可提供以下接口功能： 

◦   打开保存的标签模板:如果要打印标签模板，需要先打开保存的模板。模板可以是文件的形式，也可以是XML字符串。 
◦   保存标签模板:通过接口，可以保存打开的模板。模板可以保存为文件，也可以保存为XML字符串，以便于网络传输和存储。 
◦   设置标签格式对象的内容:标签模板上文字、条码等内容可以通过接口进行设置，也就是可以通过接口设置标签的内容。 
◦   配置打印机:通过接口，可以配置模板的目标打印机，还可以配置打印机的参数。 
◦   获取标签略图:通过接口，可以随时获取标签的略图，以便于用户可以直观的看到标签的样式。 
◦   打印标签:通过接口，可以打印指定数量的标签。 
◦   其它功能:其它更多的功能，请参考接口说明文档。 

Api 适用的编程语言
LabelShop Api 以标准的WINDOWS API方式提供，接口主要功能全部封装在一个DLL中。除了提供 C 样式的接口定义外，现阶段还提供可供 C# 使用的接口定义，未来还将提供ActiveX控件以及可供JAVA调用的接口。 

Api 的授权模式
LabelShop Api 提供免费和付费的授权模式，付费授权又分为专业版授权模式和企业版授权模式。免费模式与付费模式的差异在于：免费模式只可使用打印接口一，每次打印只能打印固定内容的标签，且打印时需要弹出一个打印窗口供用户操作；付费授权模式可以使用打印接口二，允许用户一次连续打印多个可变的标签。未授权或者授权不符时，打印的标签上会加入一行文字说明，内容为“DEMO:www.360Code.com”。 

对于只是实现简单的标签打印功能的用户，可以尝试使用免费的标准版授权模式；对于需要实现高效的标签打印，但用户量较少的用户，可以使用专业版授权模式；对于软件开发企业或者用户量多的用户，建议采用企业版授权模式。 

免费授权模式（标准版授权）
此模式针对每台电脑单独授权，用户只要在该电脑上安装了LabelShop，并且使用 360Code.com 账户激活了LabelShop标准版，就自动在此台电脑上拥有了标准版授权。可以使用打印接口一打印标签模板。 

付费授权模式（专业版授权）
此模式针对每台电脑单独授权，用户只要在该电脑上安装了LabelShop 专业版，就自动在此台电脑上拥有了专业版授权。专业版授权可以使用打印接口二，实现高效灵活的标签打印功能。 

试用和购买
可以下载 LabelShop Api 进行试用，在开发和使用中如有任何问题，请联系 360Code.com。专业版授权可以在 360Code.com 上直接下单购买，企业版授权购买，请联系 360Code.com 客服人员。

=====================================================================================
文件说明：
Lib 目录
	TLXLabelPaint.dll	接口 DLL，32位库
	TLXLabelPaint.lib	用于连接DLL
	LSLoadLsd.dll		打开 LabelShop V2 版本的 lsd 格式标签模板需要的库	
	TestTLXLabelPaint.exe	测试程序
	
	x64 目录	64位库

Include 目录
	TLXLabelPaint.h		接口函数定义
	TLXLabelPaintType.h	类型定义

C++ 目录
	C++ Demo

C# 目录
	TLXLabelPaintCLS.cs	C# 封装的接口，详细说明请参考 TLXLabelPaint.h 中的接口说明
	Demo 目录		一个完整的C#接口调用演示程序

=====================================================================================
附加说明：
	1、目前的版本为测试版本，在正式版本中，我们会保证接口的一致性
	2、对于所有的接口函数调用，请测试返回值，以判断接口调用是否成功
	3、关于授权的详细信息，请联系 360Code.com
	4、后期将提供更多的封装形式，如ActiveX 控件、JAVA接口等，请关注 360Code.com

