iText 9.0.0 API
iText.Barcodes.Barcode39 Class Reference

This class represents the barcode Code 39. More...

Inheritance diagram for iText.Barcodes.Barcode39:
iText.Barcodes.Barcode1D

Public Member Functions

  Barcode39 (PdfDocument document)
  Creates a new Barcode39. More...
 
  Barcode39 (PdfDocument document, PdfFont font)
  Creates a new Barcode39. More...
 
override Rectangle  GetBarcodeSize ()
  Gets the maximum area that the barcode and the text, if any, will occupy. More...
 
override Rectangle  PlaceBarcode (PdfCanvas canvas, Color barColor, Color textColor)
  Places the barcode in a PdfCanvas. More...
 
- Public Member Functions inherited from iText.Barcodes.Barcode1D
virtual float  GetX ()
  Gets the minimum bar width. More...
 
virtual void  SetX (float x)
  Sets the minimum bar width. More...
 
virtual float  GetN ()
  Gets the bar multiplier for wide bars. More...
 
virtual void  SetN (float n)
  Sets the bar multiplier for wide bars. More...
 
virtual PdfFont  GetFont ()
  Gets the text font. More...
 
virtual void  SetFont (PdfFont font)
  Sets the text font. More...
 
virtual float  GetSize ()
  Gets the size of the text. More...
 
virtual void  SetSize (float size)
  Sets the size of the text. More...
 
virtual float  GetBaseline ()
  Gets the text baseline. More...
 
virtual void  SetBaseline (float baseline)
  Sets the text baseline. More...
 
virtual float  GetBarHeight ()
  Gets the height of the bars. More...
 
virtual void  SetBarHeight (float barHeight)
  Sets the height of the bars. More...
 
virtual int  GetTextAlignment ()
  Gets the text alignment. More...
 
virtual void  SetTextAlignment (int textAlignment)
  Sets the text alignment. More...
 
virtual bool  IsGenerateChecksum ()
  Gets the optional checksum generation. More...
 
virtual void  SetGenerateChecksum (bool generateChecksum)
  Setter for property generateChecksum. More...
 
virtual bool  IsChecksumText ()
  Gets the property to show the generated checksum in the the text. More...
 
virtual void  SetChecksumText (bool checksumText)
  Sets the property to show the generated checksum in the the text. More...
 
virtual bool  IsStartStopText ()
  Sets the property to show the start and stop character '*' in the text for the barcode 39. More...
 
virtual void  SetStartStopText (bool startStopText)
  Gets the property to show the start and stop character '*' in the text for the barcode 39. More...
 
virtual bool  IsExtended ()
  Gets the property to generate extended barcode 39. More...
 
virtual void  SetExtended (bool extended)
  Sets the property to generate extended barcode 39. More...
 
virtual String  GetCode ()
  Gets the code to generate. More...
 
virtual void  SetCode (String code)
  Sets the code to generate. More...
 
virtual bool  IsGuardBars ()
  Gets the property to show the guard bars for barcode EAN. More...
 
virtual void  SetGuardBars (bool guardBars)
  Sets the property to show the guard bars for barcode EAN. More...
 
virtual int  GetCodeType ()
  Gets the code type. More...
 
virtual void  SetCodeType (int codeType)
  Sets the code type. More...
 
virtual float  GetInkSpreading ()
  Gets the amount of ink spreading. More...
 
virtual void  SetInkSpreading (float inkSpreading)
  Sets the amount of ink spreading. More...
 
virtual String  GetAltText ()
  Gets the alternate text. More...
 
virtual void  SetAltText (String altText)
  Sets the alternate text. More...
 
virtual PdfFormXObject  CreateFormXObject (PdfDocument document)
  Creates a PdfFormXObject with the barcode. More...
 
virtual PdfFormXObject  CreateFormXObject (Color barColor, Color textColor, PdfDocument document)
  Creates a PdfFormXObject with the barcode. More...
 
virtual void  FitWidth (float width)
  Make the barcode occupy the specified width. More...
 

Static Public Member Functions

static byte[]  GetBarsCode39 (String text)
  Creates the bars. More...
 
static String  GetCode39Ex (String text)
  Converts the extended text into a normal, escaped text, ready to generate bars. More...
 

Additional Inherited Members

- Static Public Attributes inherited from iText.Barcodes.Barcode1D
const int  ALIGN_LEFT = 1
  Constant that defines left alignment. More...
 
const int  ALIGN_RIGHT = 2
  Constant that defines right alignment. More...
 
const int  ALIGN_CENTER = 3
  Constant that defines center alignment. More...
 
- Package Functions inherited from iText.Barcodes.Barcode1D
  Barcode1D (PdfDocument document)
  Creates new Barcode1D instance. More...
 
virtual float  GetDescender ()
  Gets the descender value of the font. More...
 
- Package Attributes inherited from iText.Barcodes.Barcode1D
PdfDocument  document
 
float  x
  The minimum bar width. More...
 
float  n
  The bar multiplier for wide bars or the distance between bars for Postnet and Planet. More...
 
PdfFont  font
  The text font. More...
 
float  size
  The size of the text or the height of the shorter bar in Postnet. More...
 
float  baseline
  If positive, the text distance under the bars. More...
 
float  barHeight
  The height of the bars. More...
 
int  textAlignment
  The text alignment. More...
 
bool  generateChecksum
  The optional checksum generation. More...
 
bool  checksumText
  Shows the generated checksum in the the text. More...
 
bool  startStopText
  Show the start and stop character '*' in the text for the barcode 39 or 'ABCD' for codabar. More...
 
bool  extended
  Generates extended barcode 39. More...
 
String  code = ""
  The code to generate. More...
 
bool  guardBars
  Show the guard bars for barcode EAN. More...
 
int  codeType
  The code type. More...
 
float  inkSpreading = 0
  The ink spreading. More...
 
String  altText
  The alternate text to be used, if present. More...
 

Detailed Description

This class represents the barcode Code 39.

This class represents the barcode Code 39.

Code 39 is a variable length, discrete barcode symbology defined in ISO/IEC 16388:2007.

The Code 39 specification defines 43 characters, consisting of uppercase letters (A through Z), numeric digits (0 through 9) and a number of special characters (-, ., $, /, +, %, and space). An additional character (denoted '*') is used for both start and stop delimiters. Each character is composed of nine elements: five bars and four spaces.

Constructor & Destructor Documentation

◆ Barcode39() [1/2]

iText.Barcodes.Barcode39.Barcode39 ( PdfDocument  document )
inline

Creates a new Barcode39.

Creates a new Barcode39. To generate the font the iText.Kernel.Pdf.PdfDocument.GetDefaultFont() will be implicitly called. If you want to use this barcode in PDF/A documents, please consider using Barcode39(iText.Kernel.Pdf.PdfDocument, iText.Kernel.Font.PdfFont).

Parameters
document The document to which the barcode will be added

◆ Barcode39() [2/2]

iText.Barcodes.Barcode39.Barcode39 ( PdfDocument  document,
PdfFont  font 
)
inline

Creates a new Barcode39.

Parameters
document The document to which the barcode will be added
font The font to use

Member Function Documentation

◆ GetBarcodeSize()

override Rectangle iText.Barcodes.Barcode39.GetBarcodeSize ( )
inlinevirtual

Gets the maximum area that the barcode and the text, if any, will occupy.

Gets the maximum area that the barcode and the text, if any, will occupy. The lower left corner is always (0, 0).

Returns
the size the barcode occupies.

Implements iText.Barcodes.Barcode1D.

◆ GetBarsCode39()

static byte [] iText.Barcodes.Barcode39.GetBarsCode39 ( String  text )
inlinestatic

Creates the bars.

Parameters
text the text to create the bars. This text does not include the start and stop characters
Returns
the bars

◆ GetCode39Ex()

static String iText.Barcodes.Barcode39.GetCode39Ex ( String  text )
inlinestatic

Converts the extended text into a normal, escaped text, ready to generate bars.

Parameters
text the extended text
Returns
the escaped text

◆ PlaceBarcode()

override Rectangle iText.Barcodes.Barcode39.PlaceBarcode ( PdfCanvas  canvas,
Color  barColor,
Color  textColor 
)
inlinevirtual

Places the barcode in a PdfCanvas.

Places the barcode in a PdfCanvas. The barcode is always placed at coordinates (0, 0). Use the translation matrix to move it elsewhere.

The bars and text are written in the following colors:

barColor textColor Result
null null bars and text painted with current fill color
barColor null bars and text painted with barColor
null textColor bars painted with current color
text painted with textColor
barColor textColor bars painted with barColor
text painted with textColor
Parameters
canvas the PdfCanvas where the barcode will be placed
barColor the color of the bars. It can be null
textColor the color of the text. It can be null
Returns
the dimensions the barcode occupies

Implements iText.Barcodes.Barcode1D.