Property: MaxColumns


Specifies the maximum number of rows for the CC-C 2D component of an EAN.UCC composite barcode symbol.



{ Defined in the pPDF417Custom unit }

TPDF417_Columns = 1 .. 30;

property MaxColumns: TPDF417_Columns;


The property specifies the maximum number of columns for a CC-C 2D component of an EAN.UCC composite barcode symbol. The CC-C is one of the three choices for the 2D component in a barcode symbol encoded in EAN.UCC composite barcode symbology. It's a variant of PDF417 symbol which begins with PDF417 codeword 920. The property can be one of values from 1 to 30, they are defined in the pPDF417Custom unit.

The maximum number of columns together with the maximum number of stacked rows (specified by the MaxRows property) indicates the maximum symbol size for a CC-C 2D component of the EAN.UCC composite barcode symbol. And the minimum number of columns (specified by the MinColumns property) together with the minimum number of rows (specified by the MinRows property) indicates the minimum symbol size for it. Based on the stretch order (specified by the StretchOrder property), the smallest symbol size that accommodates the barcode text will be automatically selected between the minimum symbol size and the maximum symbol size.

If the barcode text is so long that it cannot be encoded using the maximum symbol size, an OnInvalidLength (the barcode text is specified in the Barcode property) or an OnInvalidDataLength (only for Delphi/C++ Builder 2009 or later, and the barcode text is specified in the Data property) event will occur.

The CurrentRows property can be used to get the factual number of stacked rows.

Note, if the property is set to a value less than the MinColumns property's value, the MinColumns property will be automatically changed to equal to this property's value. In other words, the MaxColumns property's value is always greater than or equal to the MinColumns property's value.

See also the "Symbol size" section in the "TBarcode2D_CCC" article.