> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BarcodeSymbol Object (IBarcodeSymbol Interface)

This object provides access to the properties of one character of a recognized barcode: character itself, rectangle of the character, character confidence and other attributes. The object is an element of the collection of barcode characters represented by the [BarcodeText](/fine-reader/engine/api-reference/text-related-objects/barcodetext) object.

## Properties

<table><thead><tr><th><p><strong>Name</strong></p></th><th><p><strong>Type</strong></p></th><th><p><strong>Description</strong></p></th></tr></thead><tbody><tr><td><p><strong>Application</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/engine-object-iengine-interface">Engine</a></strong>, <a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">read-only</a></p></td><td><p>Returns the <strong>Engine</strong> object.</p></td></tr><tr><td colspan="3"><p><a name="group_1" /><em>Barcode character</em></p></td></tr><tr><td><p><a name="character" /><strong>Character</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">BSTR</a></strong>, read-only</p></td><td><p>Stores the character.</p></td></tr><tr><td colspan="3"><p><a name="group_2" /><em>Character coordinates</em></p></td></tr><tr><td><p><a name="bottom" /><strong>Bottom</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">int</a></strong>, read-only</p></td><td rowspan="4"><p>These properties are deprecated and will be deleted in future versions.</p></td></tr><tr><td><p><a name="left" /><strong>Left</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">int</a></strong>, read-only</p></td></tr><tr><td><p><a name="right" /><strong>Right</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">int</a></strong>, read-only</p></td></tr><tr><td><p><a name="top" /><strong>Top</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">int</a></strong>, read-only</p></td></tr><tr><td colspan="3"><p><a name="group_3" /><em>Character attributes</em></p></td></tr><tr><td><p><a name="charconfidence" /><strong>CharConfidence</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">int</a></strong>, read-only</p></td><td><p>Stores the value of recognition confidence of the character. This is the confidence of the main (selected) recognition variant. It represents an estimate of this variant's accuracy in comparison to other recognition variants. However, this number is not guaranteed to be positive. It has only a relative meaning.</p></td></tr><tr><td><p><a name="isbinarydata" /><strong>IsBinaryData</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong>, read-only</p></td><td><p>Specifies whether the character represents binary data.</p><Note>The binary data can be saved as a Unicode string in two different ways depending on the value of the <a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/barcodeparams#containsbinarydata">IBarcodeParams::ContainsBinaryData</a> property. See <a href="/fine-reader/engine/guided-tour/advanced-techniques/recognizing-barcodes#binary_data_encoded_in_barcodes">Recognizing Barcodes</a> for details.</Note></td></tr><tr><td><p><a name="isbinaryzero" /><strong>IsBinaryZero</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong>, read-only</p></td><td><p>Specifies whether the character is the binary zero.</p><p>This property is only used, if the <strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/barcodeparams#containsbinarydata">IBarcodeParams::ContainsBinaryData</a> </strong>property was FALSE during recognition. In this case, the recognized binary data is translated to the Unicode string using the code page specified in the <strong><a href="/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/barcodeparams#codepage">IBarcodeParams::CodePage</a></strong> property. But the binary zero cannot be translated correctly in this way, therefore the <strong>Character</strong> property for such symbol contains the "unrecognized character" symbol ("^").</p></td></tr><tr><td><p><a name="isstartstopsymbol" /><strong>IsStartStopSymbol</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong>, read-only</p></td><td><p>Specifies whether the character is the barcode start/stop symbol. The property makes sense for barcodes of the <a href="/fine-reader/engine/specifications/barcode-types#code_39">Code 39</a> type (the start/stop symbol is the asterisk "\*") and <a href="/fine-reader/engine/specifications/barcode-types#codabar">Codabar</a> type (the start/stop symbols are Latin letters "A", "B", "C", "D").</p></td></tr></tbody></table>

## Related objects

<img src="https://mintcdn.com/abbyy/6udH-pkk8zkVafYH/images/fine-reader/engine/barcodesymbol.gif?s=63f070b5d952de1acfeb8e4b334e7fef" alt="BarcodeSymbol" width="114" height="95" data-path="images/fine-reader/engine/barcodesymbol.gif" />[](/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/fine-reader/engine/api-reference/text-related-objects/barcodetext)[](/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)

[Object Diagram](/fine-reader/engine/api-reference/object-diagram)

## Output parameter

This object is the output parameter of the [Item](/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/item-method) method the [BarcodeText](/fine-reader/engine/api-reference/text-related-objects/barcodetext) object.

## See also

[BarcodeText](/fine-reader/engine/api-reference/text-related-objects/barcodetext)

[Recognizing Barcodes](/fine-reader/engine/guided-tour/advanced-techniques/recognizing-barcodes)

[Working with Text](/fine-reader/engine/guided-tour/advanced-techniques/working-with-text)

[Working with Properties](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)