Description

Returns or sets a value for the overall height to width ratio of PDF417 symbols generated.

Syntax

object.ActualVersion = [Number] 

Remarks

The AspectRatio determines the overall shape of the PDF417 symbol and is defined as the overall height to width ratio. Higher values for the Aspect Ratio (greater than 1) produce tall, thin PDF417 bar codes and small values (greater than zero and less than 1) produce short, wide bar codes. A value of 1 produces approximately square bar codes.

Generaly speaking, a lower AspectRatio produces more space-efficient barcodes.

Setting the value to 0 allows the program to select a size that produces the least number of codewords, under the constraints of Rows and Cols specified.

The default value is 0.0 (automatic selection).

Description

BackColor - returns or sets the background color of the control.

ForeColor - returns or sets the foreground color of the control.

Syntax

object.BackColor[= Color]
object.ForeColor[= Color] 

Remarks

For open systems we strongly recommend to set the background color to solid white (0xFFFFFF) and foreground color to black (0x000000). Note: barcode requires decent contrast between the foreground color and the background color in order to be readable. Always test the readability thoroughly when you select a color pair different from black and white.

Syntax

object.Cols = Number

Description

Returns or sets a value for the number of codeword columns in PDF417 symbols generated.

Remarks

When the value is 0, the program selects one that produces the least number of codewords.

The default value is 0.

Syntax

object.CompactPDF = Boolean

Description

Returns or sets a value that determines whether to generate the compact version of PDF417 symbols.

Remarks

PDF417 standard specifies a compact version, with the stop pattern reduced to a single terminating bar. Compact version symbols should only be used in a clean and controlled environment.

The default value for this property is FALSE.

Description

Returns or sets a value that determines the width of a single module in the PDF17 symbols generated.

Syntax

object.ModuleWidth[= String] 

Remarks

The “real estate” unit of a PDF417 symbol, the module, is always rectangular. This property sets the width of the rectangle. It affects the overall symbol size.

The default value for ModuleSize is 20 mils. The property can be any numbers between 1 and 100.

This property is a string, and accepts the following units: mil, himetric, mm, cm, pt and inch. For example, “0.01cm” and “1mm” are all valid. If no measure unit is specified, unit of mil (which is 1/1000th inch) is assumed.

Description

Readonly property. Returns a snapshot of the drawing in Windows Enhanced Metafile Format (EMF).

Syntax

object.Picture

Remarks

The Picture property provides a convenient method to retrieve the drawing without first saving it to disk. The picture object contains an enhanced metafile handle which can be passed to clipboard or played on a device.

The included VB6, VC++ and C# examples use this property to retrieve an EMF handle and play it on the target printer to print the barcode.

Description

Readonly property. Returns the number of rows requested.

Syntax

object.Rows

Remarks

Set the number of rows required for PDF417 barcodes generated. 0 means automatic.

Description

Specifies the security leve in the PDF417 barcode generated.

Syntax

object.SecurityLevel = Number

Remarks

In PDF417 symbols security level is selectable and ranges between 0 and 8. Specifying 9 for automatic selection based on the amount of data encoded. The value is considered "minimum" by our software, as it will increase the security level if the size constraint allows. To retrieve the actual value of the security level, use GetActualAttributes method.

Specifies the resolution of the target printer, applicable during exporting vector graphics.

Syntax

object.TargetDPI = Number 

Remarks

Whe producing small sizes of barcodes, especailly on lowe resolution printers, lengths must be align to the boundary of pixels in order to retain high quality. The ActiveX control adjusts the drawing units automaticaly based on this property when exporting vector graphics images.

Specifies the Data to be encoded into the PDF417 symbol.

Description

Returns or sets a string for the message to be encoded.

Syntax

object.Text[= String] 

Remarks

Specifies the ratio of height of a module vs. its width.

Description

Returns or sets the y-height in the PDF417 barcode generated.

Syntax

object.YHeight[= Double] 

Remarks

For better decodability, this value should be greater than 3.0.

Copies the PDF417 image into the system clipboard, in EMF format.

Syntax

obj.CopyToClipboard 

Description

Use this method to place a copy of barcode image to the clipboard, so that you can either retrieve it immediately in your application, or other applications such as Microsoft Word.

Description

Exports the current drawing to a disk file, in raster image format (PNG or BMP).

Syntax

obj.ExportImageRaster(filename, pixelsPerModule, imageType)

Parameters

Description

Exports the current drawing to a disk file, in raster image format (EMF, SVG and EPS).

Syntax

obj.ExportImageVector(filename, imageType) 

Parameters

Description

Retrieves the actual values of atrtibutes in the PDF417 barcodes generated.

Syntax

obj.GetActualAttributes(numRows, numCols, securityLevel, aspectRatio) 

Parameters

Remarks

You can specify exact values to Rows, Cols, SecurityLevel and AspectRatio, or leave one or more of them to be determined by the program. Use this method to retrieve the actual value in the barcode generated.