Deprecation warning

Please note that this is outdated documentation for an older release of the Scandit Barcode Scanner SDK.

We are deprecating the 5.x API on all platforms (except Linux). Release 5.19 in April 2021 will be our final. Applications running 5.x will continue to work, and we will continue to release critical bug fixes and security patches only, for one year. We encourage you to migrate to 6.x and take advantage of our latest / advanced features and improved performance.

You'll find the updated documentation at: Data Capture SDK Documentation for Xamarin.Android and Data Capture SDK Documentation for Xamarin.iOS

Barcode Interface Reference

Inherits INativeObject.

Properties

string SymbologyString [get]
 
string SymbologyName [get]
 
Symbology Symbology [get]
 
string Data [get]
 
NSData RawData [get]
 
bool IsRecognized [get]
 
Quadrilateral Location [get]
 
bool IsGs1DataCarrier [get]
 
CompositeFlag CompositeFlag [get]
 

Detailed Description

Represents a recognized/localized barcode/2D code.

This class represents a 1d barcode, or 2D code that has been localized or recognized by the barcode recognition engine.

Property Documentation

string SymbologyString
get

The symbology of the barcode as a string, including GS1 data carrier states.

This property is set to one of the following values:

"EAN8", "EAN13", "UPC12", "UPCE", "CODE128", "GS1-128", "CODE39", "CODE93", "ITF", "MSI", "CODABAR", "GS1-DATABAR", "GS1-DATABAR-EXPANDED", "QR", "GS1-QR", "DATAMATRIX", "GS1-DATAMATRIX", "PDF417", "TWO-DIGIT-ADD-ON", "FIVE-DIGIT-ADD-ON", "AZTEC" "UNKNOWN".

Codes for which IsRecognized is NO, "UNKNOWN" is returned.

string SymbologyName
get

The symbology name of the barcode as a string.

Returns
Lower-case symbology name. Codes for which IsRecognized is NO, "unknown" is returned. In contrast to SymbologyString, the returned symbology does not contain any information on whether the code is a GS1 data carrier, use IsGs1DataCarrier for that.
Since
4.11.0

Returns the symbology of a recognized barcode.

Codes for which IsRecognized is NO return Symbology.Unknown.

string Data
get

The data contained in the barcode/2D code, e.g.

the 13 digit number of a EAN13 code.

For some types of barcodes/2D codes (for example DATAMATRIX, AZTEC, PDF417), the data string may contain non-printable characters and nul-bytes in the middle of the string. Data may be nil in these cases. Use RawData if your application scans these types of codes and you are expecting binary/non- printable data.

NSData RawData
get

The raw byte data contained in the barcode.

Use this method in case you are encoding binary data in barcodes\2D codes that can not be represented as UTF-8 strings. For codes that are localized but not recognized, nil is returned.

bool IsRecognized
get

Whether the code was completely recognized.

This property is true for barcodes that were completely recognized and false for codes that were localized but not recognized. For codes returned by ScanditBarcodeScanner.iOS.IScanSession.NewlyRecognizedCodes and ScanditBarcodeScanner.iOS.IScanSession.AllRecognizedCodes IsRecognized always returns true, for codes returned by ScanditBarcodeScanner.iOS.IScanSession.NewlyLocalizedCodes IsRecognized always returns NO.

Quadrilateral Location
get

The location of the code in the image.

The location is returned as a a polygon with 4 corners. The corners are in the coordinate system of the raw preview image. In order to be displayed they must be transformed to the coordinate system of the view. The meaning of the values of topLeft, topRight etc is such that the topLeft point corresponds to the top-left corner of the barcode regardless of how it is oriented in the image.

See also
ScanditBarcodeScanner.iOS.BarcodePicker.ConvertPointToPickerCoordinates:
bool IsGs1DataCarrier
get

Whether the code is a GS1 data carrier.

Returns
True if the code is a GS1 data carrier, false if not. False is returned for codes that have only been localized but not recognized.
Since
4.11.0

Indicates whether the code is part of a composite pair.

Returns
The composite flag for the code.
Since
4.14.0