Property: MaxRows

(TBarcode2D_CCA)

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

Syntax:

type

{ Defined in the pCCA unit }

TCCA_Rows = (ccaRow_3, ccaRow_4, ccaRow_5, ccaRow_6, ccaRow_7, ccaRow_8, ccaRow_9, ccaRow_10, ccaRow_12);

property MaxRows: TCCA_Rows;

Description:

The property specifies the maximum number of stacked rows for a CC-A 2D component of an EAN.UCC composite barcode symbol. It can be one of these values: ccaRow_3, ccaRow_4, ccaRow_5, ccaRow_6, ccaRow_7, ccaRow_8, ccaRow_9, ccaRow_10, and ccaRow_12, corresponding to the number of stacked rows 3, 4, 5, 6, 7, 8, 9, 10, and 12. For example, the value ccaRow_12 denotations the maximum number of stacked rows is 12 rows. These values are defined in the pCCA unit. The CC-A is one of the three choices for the 2D component in a barcode symbol encoded in EAN.UCC composite barcode symbology.

The smallest number of stacked rows that accommodates the barcode text will be automatically selected between the minimum number of stacked rows (specified by the MinRows property) and the maximum number of stacked rows (specified by this property).

Note, only available number of stacked rows can be automatically selected between the range specified by the MinRows property and this property depending on the linear component of the EAN.UCC composite symbol (specified by the Linear property). They are listed in the following table:

Linear componentAvailiable number of stacked rows
UPC-E, UPC-E0, UPC-E1,
RSS-14 Stacked, RSS-14 Stacked Omnidirectional
ccaRow_5, ccaRow_6, ccaRow_7, ccaRow_8, ccaRow_9, ccaRow_10, ccaRow_12
EAN-8, RSS LimitedccaRow_4, ccaRow_5, ccaRow_6, ccaRow_7, ccaRow_8
UPC-A, EAN-13, EAN-128,
RSS-14 Standard, RSS-14 Truncated,
RSS Expanded, RSS Expanded Stacked
ccaRow_3, ccaRow_4, ccaRow_5, ccaRow_6, ccaRow_7

If the barcode text is so long that it cannot be encoded using the maximum number of stacked rows specified by this property, 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 MinRows property's value, the MinRows property will be automatically changed to equal to this property's value. In other words, the MaxRows property's value is always greater than or equal to the MinRows property's value.

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

Contents