In This Topic
The BarcodeOptions provides additional properties for rendering barcodes in Reports for WinForms. Following are the common properties exposed by BarcodeOptions:
- BarDirection: Lets you select the barcode's direction, horizontally or vertically. The available options are LeftToRight, RightToLeft, TopToBottom, and BottomToTop. The direction of barcode can also be set using BarDirectionEnum.
- CaptionGrouping: Lets you split the text of the caption into groups for the barcode types it supports. Its value is either True or False.
- CaptionPosition: Lets you select the caption's vertical position relative to the barcode symbol. The available options are None, Above, and Below.
- CheckSumEnabled: Determines whether a checksum of the barcode will be computed and included in the barcode when applicable.
- TextAlign: Lets you select the caption text alignment. The available options are Left, Center, and Right.
- SupplementNumber: Lets you specify the supplement for the barcode data, supplement is 2 or 5 digit for EAN or UPC symbologies.
-
SizeOptions:
- BarHeight: Specifies the height of a barcode in twips.
- ModuleSize: Specifies the module (narrowest bar width) of a barcode in twips.
- NarrowWideRatio: Specifies the ratio between the width of narrow and wide bars.
-
SizeMode: Specifies the sizing mode of a barcode. The options available are:
-
- Normal: Keeps the size of a barcode same as the original size.
- Scale: Scales the barcode image to take as much field area as possible. Different type of barcodes are scaled in different ways; for example, in Bar type barcodes like Code128, the height is increased and in barcodes such as Matrix, Rss, and Composite, height and width get scaled proportionally.
- SupplementSpacing: Specifies the spacing between the main and the supplement barcodes.
Other options exposed by BarcodeOptions corresponding to different barcode styles are as follows:
Code49:
- Grouping: Lets you use grouping in the barcode. Its value is either True or False.
- Group: Obtains or sets group numbers for barcode grouping. Its value is between 0 and 8.
DataMatrix:
- EccMode: Lets you select the ECC mode. The possible values are ECC000, ECC050, ECC080, ECC100, ECC140, or ECC200.
- Ecc200SymbolSize: Lets you select the size of the ECC200 symbol. The default value is SquareAuto.
- Ecc200EncodingMode: Lets you select the ECC200 encoding mode. The possible values are Auto, ASCII, C40, Text, X12, EDIFACT, or Base256.
- Ecc000_140SymbolSize: Lets you select the size of the ECC000_140 symbol.
- StructuredAppend: Lets you select whether the current barcode symbol is part of structured append symbols.
- StructureNumber: Lets you specify the structure number of the current symbol within the structured append symbols.
- FileIdentifier: Lets you specify the file identifier of a related group of structured append symbols. The valid file indentifier value should be within [1,254]. Setting file identifier to 0 lets the file identifier be calculated automatically.
GS1Composite:
- Type: Lets you select the composite symbol type. Its value can be None or CCA. CCA (Composite Component - Version A) is the smallest variant of the 2-dimensional composite component.
- Value: Gets or sets the CCA character data.
MicroPDF417:
- CompactionMode: Lets you select the type of CompactionMode. The possible values are Auto, TextCompactionMode, NumericCompactionMode, or ByteCompactionMode.
- FileID: Lets you specify the file id of the structured append symbol. It takes the value from 0 to 899.
- SegmentCount: Lets you specify the segment count of the structured append symbol. It takes the value from 0 to 99999.
- SegmentIndex: Lets you specify the segment index of the structured append symbol. It takes the value from 0 to 99998 and less than the value of segment count.
- Version: Lets you select the symbol size. The default value is ColumnPriorAuto.
PDF417:
- Column: Lets you specify the column numbers for the barcode.
- Row: Lets you specify the row numbers for the barcode.
- ErrorLevel: Lets you specify the error correction level for the barcode.
- Type: Lets you select the type of PDF417 barcode. The available types are Normal and Simple.
QRCode
- Model: Lets you select the model of QRCode. The available models are Model1 and Model2.
- ErrorLevel: Lets you select the error correction level for the barcode. The available options are Low, Medium, Quality, and High.
- Version: Lets you specify the version of the barcode.
- Mask: Lets you select the pattern used for masking barcode. In order to make sure QRCode being successfully read, mask process is required to balance brightness. The options available are Auto, Mask000, Mask001, Mask010, Mask011, Mask100, Mask101, Mask110, and Mask111.
- Connection: Lets you select whether connection is used for the barcode. It takes the value True of False.
- ConnectionNumber: Lets you specify the connection number for the barcode. It takes the integer value ranging from 0 to 15.
RssExpandedStacked:
- RowCount: Lets you specify the number of stacked rows.
The quiet zones for barcodes can be specified easily by using MarginBottom, MarginLeft, MarginRight, and MarginTop properties in the Property window of the C1ReportDesigner.