Property: MaxVersion


Specifies the maximum version for a Compact Matrix barcode symbol.



{ Defined in the pCompactMatrix unit }

TCompactMatrix_Version = 1..32;

property MaxVersion: TCompactMatrix_Version;


There are 32 vertical sizes of Compact Matrix symbol, referred to as version 1 to 32, in increasing order of symbol height and data capacity. The property specifies the maximum version for a Compact Matrix barcode symbol. It can be one of values from 1 to 32. They are defined in the pCompactMatrix unit.

The maximum version together with the maximum number of segments (specified by the MaxSegments property) indicates the maximum symbol size for a Compact Matrix barcode symbol. And the minimum version (specified by the MinVersion property) together with the minimum number of segments (specified by the MinSegments property) indicates the minimum symbol size for the Compact Matrix barcode symbol. 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 CurrentVersion property can be used to get the factual version.

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

See also the "Symbol sizes" section in the "TBarcode2D_CompactMatrix" article.