Property: BarcodeWidth

Specifies the distance between the beginning and end of a barcode symbol in pixels.

Syntax:

property BarcodeWidth: Single;

Description:

Specifies the distance between the beginning and end of a barcode symbol in pixels. If the quiet zones are drawn (the ShowQuietZone property is set to true), the leading quiet zone and the trailing quiet zone are included. See diagram (the SpaceColor property value is set to claSilver in order to accentuate the quiet zones):

The property is set using the following formula:

• When the property Stretch is set to false:

  The BarcodeWidth property will be ignored, and the width of barcode symbol will be calculated based on the Module property value.

  You can get the width value by using the Size method.

• When the property Stretch is set to true:

  • If the property value is equal to zero:

    When the Orientation property is set to "boLeftRight" or "boRightLeft", the LeftMargin property value will be subtracted from the width of the TImage control that's specified by the Image property, then the result will be used as the final barcode width, the barcode symbol will be reduced/stretched to fit this final width value. See diagram (the SpaceColor property value is set to claSilver in order to accentuate the quiet zones):

    

    When the Orientation property is set to "boTopBottom" or "boBottomTop", the TopMargin property value will be subtracted from the height of the TImage control that's specified by the Image property, then the result will be used as the final barcode width, the barcode symbol will be reduced/stretched to fit this final width value. See diagram (the SpaceColor property value is set to claSilver in order to accentuate the quiet zones):

    

  • If the property value is greater than zero:

    The barcode symbol will be reduced/stretched to fit this width value. See diagram (the SpaceColor property value is set to claSilver in order to accentuate the quiet zones):

    

  • If the property value is less than zero:

    When the Orientation property is set to "boLeftRight" or "boRightLeft", the LeftMargin property value and the absolute value of the negative width will be subtracted from the width of the TImage control that's specified by the Image property, then the result will be used as the final barcode width, the barcode symbol will be reduced/stretched to fit this final width value (it specifies the right margin of the barcode symbol, -1 denotes the right margin is 1, -2 denotes the right margin is 2, ...). See diagram (the SpaceColor property value is set to claSilver in order to accentuate the quiet zones):

    

    When the Orientation property is set to "boTopBottom" or "boBottomTop", the TopMargin property value and the absolute value of the negative width will be subtracted from the height of the TImage control that's specified by the Image property, then the result will be used as the final barcode width, the barcode symbol will be reduced/stretched to fit this final width value (it specifies the bottom margin of the barcode symbol, -1 denotes the bottom margin is 1, -2 denotes the bottom margin is 2, ...). See diagram (the SpaceColor property value is set to claSilver in order to accentuate the quiet zones):

    

Note:

For the TBarcodeFmx2D_Code16K barcode component, the leading quiet zone and the trailing quiet zone are included always, even if the ShowQuietZone property is set to false. See diagram (the SpaceColor property value is set to claSilver in order to accentuate the quiet zones):

Contents