CITIZEN 바코드 라벨 프린터 소프트웨어 개발 도구 - CITIZEN Windows Label Print SDK

CITIZEN 바코드 라벨 프린터 라벨 출력 프로그램 개발을 위한 SDK 입니다.

이 자료는 Windows 응용 프로그램에서 CITIZEN 라벨프린터를 제어하려는 개발자를 위해 제작되었습니다.

​

 

수정내역

 

날짜	Ver	설명
2016.4.26	1.00	최초 발행
2017.3.3	1.01	- Renamed the namespace to "com.citizen.sdk.labelPrint". - Added Bluetooth as a connect type of the Connect method, the SearchCitizenPrinter method and the SearchESCPOSPrinter method. - Added an explanation of ParallelErrorOutput to PrinterCheck method. - Added the Preview method. - Added the measurementUnit as a parameter of DrawTextPCFont method. - Added the resolution and measurementUnit as a parameter of DrawBitmap Method.
2017.9.29		- Added CL-E300/CL-E303 to support model. - Update “Confirmed Driver Version”.
2018.1.24		- Added CL-E321/CL-E331 to support model. - Update “Confirmed Driver Version”.
2018.9.18	1.02	- Added Bluetooth as a interface of CL-E720/730 model. - Modified the printer model name. - Added a locale for Chinese model and Korean model to DrawTextPtrFont. - Added the Chinese model and the Korean model to the definition of the locale.
2019.8.28	1.03	- Modified explanation and usage example of PrinterCheck method. - Added PrintHeadLowTemp, PrintHeadFailure, PrintHeadOverheat, MechanismOpen, AutoCutterError, FanMotorError, MiscError properties to the LabelPrinter class. - Modified explanation of resolution and measurementUnit parameter of DrawTextPCFont method. - Modified explanation of measurementUnit parameter of DrawBitmap method.
2019.11.12		- Added CL-S700II/703II, CL-S621II/631II and CL-S521II/531II to support model. - Windows driver version description changed to driver name description. - Modified model name of Windows driver target model. - Modified invalidation of status function of Windows driver.
2020.6.2		- Added CL-E300EX/303EX and CL-E321EX/331EX to support model. - Windows driver version description changed to driver name description.
2021.11.26	1.04	- Added Windows11 to the supported operating systems.

​

​

시스템 요약

 

이 SDK는 Windows 응용 프로그램에서 Citizen Label 프린터를 제어하기 위해 참조합니다.

System diagram of the SDK

 

 

Library files

 

이 SDK는 다음 세 개의 파일로 구성되어 있고 응용 프로그램과 같은 폴더에 저장되어야 합니다.

- CSJLabelLib.dll : Main library file

- CSJLabelLibW32.dll : Extended library for 32bit processor (Referred by CSJLabelLib.dll)

- CSJLabelLibW64.dll : Extended library for 64bit processor (Referred by CSJLabelLib.dll)

​

 

---

 

지원되는 윈도우 버전

 

- Windows XP

- Windows 7 (32bit, 64bit)

- Windows 8 (32bit, 64bit)

- Windows 8.1 (32bit, 64bit)

- Windows 10 (32bit, 64bit)

- Windows 11 (64bit)

​

---

 

지원되는 .Net Framework 버전

 

- Microsoft .NET Framework 2.0 SP2

- Microsoft .NET Framework 3.5 SP1

- Microsoft .NET Framework 4.0

- Microsoft .NET Framework 4.5

- Microsoft .NET Framework 4.6

- Microsoft .NET Framework 4.7

- Microsoft .NET Framework 4.8

 

---

 

지원되는 바코드 프린터 모델

 

모델명	인터페이스	인쇄 방식
CL-S700 / 703	유/무선 LAN, USB, COM, LPT	직접열전사 / 열전사전송
CL-S700II / 703II	유/무선 LAN, USB, COM, LPT	직접열전사 / 열전사전송
CL-E720 / 730	유/무선 LAN, USB, COM, LPT, 블루투스	직접열전사 / 열전사전송
CL-S621 / 631	유/무선 LAN, USB, COM, LPT	직접열전사 / 열전사전송
CL-S621II / 631II	유/무선 LAN, USB, COM, LPT	직접열전사 / 열전사전송
CL-S521 / 531	유/무선 LAN, USB, COM, LPT	직접열전사
CL-S521II / 531II	유/무선 LAN, USB, COM, LPT	직접열전사
CL-S400DT	유/무선 LAN, USB, COM, LPT, 블루투스	직접열전사
CL-E300 / 303	유선 LAN, USB, COM	직접열전사
CL-E300EX / 303EX	유/무선 LAN, USB, COM, 블루투스	직접열전사
CL-E321 / 331	유선 LAN, USB, COM	직접열전사 / 열전사전송
CL-E321EX / 331EX	유/무선 LAN, USB, COM, 블루투스	직접열전사 / 열전사전송

자세한 내용은 각 사용 설명서를 참조하십시오.

​

USB 인터페이스 연결

USB 인터페이스에는 Windows 프린터 드라이버를 설치해야 합니다.

​

Parallel 인터페이스 연결

병렬 인터페이스에는 Windows 프린터 드라이버를 설치하는 것이 좋습니다. 그렇지 않으면

프린터가 연결되고 전원이 켜질 때마다 드라이버 설치 마법사 창이 나타납니다.

​

Windows 드라이버 설치

지원되는 윈도우즈 드라이버는 다음과 같습니다. 자세한 내용은 설명서를 참조하십시오.

 

모델명	드라이버
CL-S700 / 703	CITIZEN DPL Driver
CL-S700II / 703II
CL-E720 / 730
CL-S621 / 631
CL-S621II / 631II
CL-S521 / 531
CL-S521II / 531II
CL-S400DT
CL-E300 / 303
CL-E300EX / 303EX
CL-E321 / 331
CL-E321EX / 331EX

 

---

 

* Windows 드라이버에서는 상태 모니터링 기능을 해제해야 합니다.

상태 열기 [도구] 탭의 [모니터링] 설정을 [사용 불가능]으로 설정합니다.

 

 

---

 

.net 프로젝트에 라이브러리 추가

라이브러리 추가

솔루션 탐색기 창에서 세 개의 dll 파일을 .net 응용 프로그램에 끌어다 놓기만 하면 됩니다.

(아래 그림은 Visual C# 2010 프로젝트의 예입니다.)

그런 다음 각 dll 파일을 강조 표시하고 "출력 디렉토리에 복사" 속성에 대해 "항상 복사"를 선택합니다.

 

---

 

Reference 추가

[Project>Add Reference로 이동하여 "CSJ LabelLib.dll"을 선택하고 "확인"을 클릭합니다. 다른 두 개의 dll 파일을 추가할 필요가 없습니다.

 

 

---

 

namespace 추가

namespace에 대한 참조 "com.citizen.sdk.LabelPrint" 는 프로그램 소스 코드의 맨 위에 명시되어야 합니다.

C#: using com.citizen.sdk.LabelPrint;

Visual Basic: Imports com.citizen.sdk.LabelPrint

VC++: using namespace com::citizen::sdk::LabelPrint;

 

---

 

예제 프로그램

 

SDK를 사용한 C# 예제

// Create an instance( LabelDesign class )
LabelDesign design = new LabelDesign();

// Text
design.DrawTextPtrFont("Sample Print",
    LabelConst.CLS_LOCALE_JP, LabelConst.CLS_PRT_FNT_TRIUMVIRATE_B,
    LabelConst.CLS_RT_NORMAL, 1, 1, LabelConst.CLS_PRT_FNT_SIZE_24, 20, 300);

// QRCode
design.DrawQRCode("DrawQRCode",
    LabelConst.CLS_ENC_CDPG_IBM850, LabelConst.CLS_RT_NORMAL, 4,
    LabelConst.CLS_QRCODE_EC_LEVEL_H, 20, 220);

// Rect(fill)
design.FillRect(20, 150, 350, 40, LabelConst.CLS_SHADED_PTN_11);

// BarCode
design.DrawBarCode("0123456789",
    LabelConst.CLS_BCS_CODE128, LabelConst.CLS_RT_NORMAL,
    3, 3, 30, 20, 70, LabelConst.CLS_BCS_TEXT_SHOW);

// Create an instance( LabelPrinter class )
LabelPrinter printer = new LabelPrinter();

// Set COMM Properties( COMM only )
printer.SetCommProperties(LabelConst.CLS_COM_BAUDRATE_9600,
    LabelConst.CLS_COM_PARITY_NONE, LabelConst.CLS_COM_HANDSHAKE_DTRDSR);

// Connect printer
int result = printer.Connect(LabelConst.CLS_PORT_COM, "COM1:");
if (LabelConst.CLS_SUCCESS == result)
{
    // Get Properties
    int printDarkness = printer.GetPrintDarkness();
    if (LabelConst.CLS_PROPERTY_DEFAULT == printDarkness)
    {
        // Set Properties
        printer.SetPrintDarkness(10);
    }
    // Print Label
    printer.Print(design, 0001);
    // Disconnect
    printer.Disconnect();
    if (LabelConst.CLS_SUCCESS == result)
    {
        // Print Error
        MessageBox.Show("Print Error : " + result.ToString(),
        "Citizen_Label_sample", MessageBoxButtons.OK,
        MessageBoxIcon.Error);
    }
}
else
{
    // Connect Error
    MessageBox.Show("Connect Error : " + result.ToString(),
    "Citizen_Label_sample", MessageBoxButtons.OK,
    MessageBoxIcon.Error);
}

 

 

프로그램 실행 결과

---

첨부된 압축 파일안에 예제 프로그램과 프로그래밍 매뉴얼이 있습니다.

CSJWindowsLabelSDK.zip

4.54MB