CaysnPrinter开发包接口说明文档 - PrinterLibs For Windows

CaysnPrinter开发包及接口说明文档下载地址：

http://download.csdn.net/download/caysnprinter/9536461

打印机接口说明

 

 

一 概述 3

二 函数说明 4

Port Function 4

Port_OpenCom 4

Port_OpenTcp 6

Port_OpenUsb 7

Port_OpenLpt 8

Port_OpenPrn 9

Port_CloseCom 10

Port_CloseTcp 11

Port_CloseUsb 12

Port_CloseLpt 13

Port_ClosePrn 14

Port_SetPort 15

Port_EnumCom 16

Port_EnumLpt 17

Port_EnumUsb 18

Port_EnumPrn 19

Page Function 20

PAGE_PageEnter 20

PAGE_PagePrint 21

PAGE_PageExit 22

PAGE_SetPrintArea 23

PAGE_DrawString 25

PAGE_DrawRect 27

PAGE_DrawBarcode 28

PAGE_DrawQRCode 30

PAGE_DrawBitmap 31

Pos Function 32

POS_TextOut 32

POS_SetBarcode 34

POS_SetQRCode 36

POS_PrintPicture 37

POS_SelfTest 38

POS_Query 39

POS_RTQuery 40

POS_TicketSucceed 42

POS_FeedLine 43

POS_FeedNLine 44

POS_FeedNDot 45

POS_SetMotionUnit 46

POS_SetLineHeight 47

POS_SetRightSpacing 48

POS_SetAlign 49

POS_Reset 51

POS_KickOutDrawer 52

POS_CutPaper 53

POS_FeedAndCut 54

POS_Beep 55

 

 

一 概述

 

1 PrinterLibs是在Windows平台用C++编写的DLL，DLL导出C风格的函数。

 

2 PrinterLibs函数有以下几类

A Port_XXX

以Port开头的函数，主要是打开端口，关闭端口，枚举端口。

支持通过串口，并口，USB口，网口进行打印。

 

备注：Port_SetPort：该函数可以指定POS_XXX系列函数所使用的通讯端口。

 

B PAGE_XXX

以PAGE开头的函数，封装了页模式指令，可以控制打印机以页模式的方式

打印。

① PAGE_PageEnter进入页模式

② PAGE_SetPrintArea设置页模式打印区域

③ PAGE_DrawXXX系列函数在指定区域打印

④ PAGE_PagePrint打印整个页面

⑤ PAGE_PageExit退出页模式

备注：

②③可以重复调用

仅支持页模式的机型可以使用这些函数

 

C POS_XXX

以POS开头的函数，主要是封装了ESC/POS指令，可以控制打印机打印。

① 进纸系列函数可以控制打印机进纸

② 设置系列函数可以设置打印的格式等

③ 打印系列函数可以打印文本，条码，QR码，图片等

④ 查询系列函数可以查询打印机状态

⑤ 其他函数可以控制钱箱、切刀、蜂鸣器等

 

 

 

 

 

 

 

 

 

二 函数说明

 

Port Function

 

Port_OpenCom

 

 

 

Syntax

BOOL Port_OpenCom(TCHAR * pName, DWORD dwBaudrate, DWORD dwParity)

 

Parameters

pName

端口名称。

例如：COM1,COM2,COM3...COM11...

 

dwBaudrate

波特率

一般取9600,19200,38400,57600,115200.

需要和打印机波特率保持一致，建议使用高波特率以获得较好的打印速度

 

dwParity

效验位

取值如下：

#define PARITY_NONE       ((WORD)0x0100)

#define PARITY_ODD        ((WORD)0x0200)

#define PARITY_EVEN       ((WORD)0x0400)

#define PARITY_MARK       ((WORD)0x0800)

#define PARITY_SPACE      ((WORD)0x1000)

 

Return value

如果打开成功，返回TRUE。否则，返回FALSE

 

Remarks

如果串口被占用，打开串口会失败。

如果波特率和打印机波特率不匹配，则无法打印。

 

Port_OpenTcp

 

 

 

Syntax

BOOL Port_OpenTcp(TCHAR * szIp, USHORT nPort)

 

Parameters

szIp

IP地址

例如：192.168.1.87

 

nPort

端口号

固定值：9100

 

Return value

如果打开成功，返回TRUE。否则，返回FALSE

 

Remarks

PC和打印机需要同网段的才可以连接

 

 

Port_OpenUsb

 

 

 

Syntax

BOOL Port_OpenUsb(TCHAR * pName)

 

Parameters

pName

端口名称。

可以通过Port_EnumUSB来得到打印机的名称。

也可以使用任意其他字符串，这时候，如果找到Caysn的USB打印机，会直接打开

 

Return value

如果打开成功，返回TRUE。否则，返回FALSE

 

Remarks

Caysn的USB打印机接到电脑上，如果设备管理器中出现了USB Printing Support，则可以使用该函数打开。

如果出现的是 Prolific USB-to-Serial Comm Port，则说明这是USB虚拟串口，需要使用Port_OpenCom。

 

Port_OpenLpt

 

 

 

Syntax

BOOL Port_OpenLpt(TCHAR * pName)

 

Parameters

pName

端口名称。

例如：LPT1,LPT2,LPT3...

 

Return value

如果打开成功，返回TRUE。否则，返回FALSE

 

Remarks

并口只有单向通讯，只可写不可读。

一切查询状态的函数，对并口来说均是无效的。

 

 

Port_OpenPrn

 

 

 

Syntax

BOOL Port_OpenPrn(TCHAR * pName)

 

Parameters

pName

打印机名称。

例如：KP80 Printer