QLPrintSettings

Settings to print on QL series.

Overview

You use this object to set parameters to your printer such as a paper size. The images or PDFs you passed to print functions in PrinterDriver are converted to printable data for specified printer by using this settings. Therefore, you receive an error if the paper size you set to this object don't correspond with an actual paper size set in your printer.

This class also implements PrintImageSettings, allowing you to configure image-specific print settings.

Instance methods

QLPrintSettings

Initialize this class with your printer model.

Declaration

public QLPrintSettings(PrinterModel printerModel);

Parameters

Name	Type	Description
printerModel	PrinterModel	the printer you use

Return Value

An instance of this class.

copyPrintSettings

Create a new instance with new printer model.

Declaration

public QLPrintSettings copyPrintSettings(PrinterModel printerModel);

Parameters

Name	Type	Description
printerModel	PrinterModel	the printer you use

Return Value

An instance of this class.

Properties

labelSize

A label size set in your printer. You need to check/set this value before printing. For allowed values, see LabelSize.

Declaration

public LabelSize getLabelSize();
public void setLabelSize(LabelSize labelSize);

autoCut

Whether the auto-cut is enabled or not. If true, printer cut the paper each page.

Declaration

public boolean isAutoCut();
public void setAutoCut(boolean autoCut);

cutAtEnd

Whether the cut at the end of last page of your printing is enabled or not. If true, printer cut the end of the label.

Declaration

public boolean isCutAtEnd();
public void setCutAtEnd(boolean cutAtEnd);

autoCutForEachPageCount

A number of pages to cut. Default value is 1. If set 1, printer cut the paper each print a page. If set 3, printer cut the paper every print three pages. This value is effective when autoCut is YES.

Declaration

public int getAutoCutForEachPageCount()
public void setAutoCutForEachPageCount(int autoCutForEachPageCount)

resolution

A resolution of printing. Whether or not this has an effect is depend on your printer. For allowed values, see Resolution.

Declaration

public Resolution getResolution();
public void setResolution(Resolution resolution);

biColorRedEnhancement

Enhancement red color. Value range is from -20 to 20. Default value is 0.
This value is effective when labelSize is RollW62RB.

Declaration

public int getBiColorRedEnhancement()
public void setBiColorRedEnhancement(int biColorRedEnhancement)

biColorGreenEnhancement

Enhancement green color. Value range is from -20 to 20. Default value is 0.
This value is effective when labelSize is RollW62RB.

Declaration

public int getBiColorGreenEnhancement()
public void setBiColorGreenEnhancement(int biColorGreenEnhancement)

biColorBlueEnhancement

Enhancement blue color. Value range is from -20 to 20. Default value is 0.
This value is effective when labelSize is RollW62RB.

Declaration

public int getBiColorBlueEnhancement()
public void setBiColorBlueEnhancement(int biColorBlueEnhancement)

feedDirectionMargins

The margins in the feed direction. Adds the same amount to the top and bottom in the feed direction. The unit is in dots.

Declaration

public int getFeedDirectionMargins();
public void setFeedDirectionMargins(int feedDirectionMargins);

Types

LabelSize

Declaration

public enum LabelSize {
    DieCutW17H54,
    DieCutW17H87,
    DieCutW23H23,
    DieCutW29H42,
    DieCutW29H90,
    DieCutW38H90,
    DieCutW39H48,
    DieCutW52H29,
    DieCutW62H29,
    DieCutW62H60,  //QL-8xx series only
    DieCutW62H75,  //QL-8xx series only
    DieCutW62H100,
    DieCutW60H86,
    DieCutW54H29,
    DieCutW102H51,
    DieCutW102H152,
    DieCutW103H164,
    RollW12,
    RollW29,
    RollW38,
    RollW50,
    RollW54,
    RollW62,
    RollW62RB,
    RollW102,
    RollW103,
    DTRollW90,
    DTRollW102,
    DTRollW102H51,
    DTRollW102H152,
    RoundW12DIA,
    RoundW24DIA,
    RoundW58DIA, 
}