BarcodeReadSymbologyStatus Enumeration

Summary

Determines the barcode read operation status.

Syntax

Objective-C

C++/CLI

Java

Python

[SerializableAttribute()] 
public enum BarcodeReadSymbologyStatus

typedef NS_ENUM(NSInteger, LTBarcodeReadSymbologyStatus) { 
 LTBarcodeReadSymbologyStatusContinue,  
 LTBarcodeReadSymbologyStatusSkip,  
 LTBarcodeReadSymbologyStatusAbort 
};

public enum BarcodeReadSymbologyStatus

[SerializableAttribute()] 
public enum class BarcodeReadSymbologyStatus

class BarcodeReadSymbologyStatus(Enum): 
   Continue = 0 
   Skip = 1 
   Abort = 2

Members

Value	Member	Description
0	Continue	Continue reading the next barcode(s) (if any). This is the default behavior.
1	Skip	Skip reading the current barcode symbologies and move to the next (if any). Setting BarcodeReadSymbologyEventArgs.Status to Skip will have an effect only if the BarcodeEngine is about to read the barcodes. i.e., when the value of BarcodeReadSymbologyEventArgs.Operation is BarcodeReadSymbologyOperation.PreRead. When the operation is BarcodeReadSymbologyOperation.PostRead and the reader has finished reading the barcodes, then setting the status to Skip will have no effect.
2	Abort	Abort the read operation. The BarcodeReader will stop trying reading barcodes and the read operation will end. This can be used when the BarcodeReadSymbologyEventArgs.Operation is BarcodeReadSymbologyOperation.PreRead or BarcodeReadSymbologyOperation.PostRead.

Value

Member

Description

Continue

Continue reading the next barcode(s) (if any). This is the default behavior.

Skip

Skip reading the current barcode symbologies and move to the next (if any). Setting BarcodeReadSymbologyEventArgs.Status to Skip will have an effect only if the BarcodeEngine is about to read the barcodes. i.e., when the value of BarcodeReadSymbologyEventArgs.Operation is BarcodeReadSymbologyOperation.PreRead.

When the operation is BarcodeReadSymbologyOperation.PostRead and the reader has finished reading the barcodes, then setting the status to Skip will have no effect.

Abort

Abort the read operation. The BarcodeReader will stop trying reading barcodes and the read operation will end. This can be used when the BarcodeReadSymbologyEventArgs.Operation is BarcodeReadSymbologyOperation.PreRead or BarcodeReadSymbologyOperation.PostRead.

Remarks

The BarcodeReadSymbologyStatus enumeration is used as the data member for the BarcodeReadSymbologyEventArgs.Status property. It can be used to determine the next action performed by the BarcodeReader.

Refer to BarcodeReadSymbologyEventArgs.Status for more information.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Barcode; 
using Leadtools.ImageProcessing; 
 
 
public void BarcodeReader_ReadSymbologyExample() 
{ 
   string imageFileName = Path.Combine(LEAD_VARS.ImagesDir, "Barcode1.tif"); 
 
   // Create a Barcode engine 
   BarcodeEngine engine = new BarcodeEngine(); 
 
   // Get the Barcode reader instance 
   BarcodeReader reader = engine.Reader; 
          
   // Load the image 
   using (RasterCodecs codecs = new RasterCodecs()) 
   { 
      using (RasterImage image = codecs.Load(imageFileName, 0, CodecsLoadByteOrder.BgrOrGray, 1, 1)) 
      { 
         // Subscribe to the ReadSymbology event 
         reader.ReadSymbology += new EventHandler<BarcodeReadSymbologyEventArgs>(reader_ReadSymbology); 
         // Read all barcodes in the image 
         reader.ReadBarcodes(image, LeadRect.Empty, 0, null); 
         reader.ReadSymbology -= new EventHandler<BarcodeReadSymbologyEventArgs>(reader_ReadSymbology); 
      } 
   } 
} 
 
private void reader_ReadSymbology(object sender, BarcodeReadSymbologyEventArgs e) 
{ 
   if (e.Operation == BarcodeReadSymbologyOperation.PreRead) 
   { 
      // Before reading, show the symbologies the engine is going to try to read 
      Console.WriteLine("Trying to read the following symbologies:"); 
      BarcodeSymbology[] symbologies = e.GetSymbologies(); 
      for (int i = 0; i < symbologies.Length; i++) 
      { 
         Console.Write(symbologies[i]); 
         if (i != (symbologies.Length - 1)) 
         { 
            Console.Write(", "); 
            Console.WriteLine(e.Options.FriendlyName); 
         } 
         else 
         { 
            Console.WriteLine(); 
         } 
      } 
   } 
   else if (e.Operation == BarcodeReadSymbologyOperation.PostRead) 
   { 
      if (e.Error == null) 
      { 
         // No errors 
         BarcodeData barcode = e.Data; 
         if (barcode != null) 
         { 
            // Found a barcode, show it 
            Console.WriteLine("  {0} at {1} with data {2}", barcode.Symbology, barcode.Bounds, barcode.Value); 
         } 
         else 
         { 
            Console.WriteLine("  No barcodes found"); 
         } 
      } 
      else 
      { 
         // Show the error 
         Console.WriteLine("Error: {0}", e.Error.Message); 
 
         // Tell the reader top stop reading barcodes 
         e.Status = BarcodeReadSymbologyStatus.Abort; 
      } 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms

Reference

Leadtools.Barcode Namespace

Download our FREE evaluation

Help Version 22.0.2023.5.9

Leadtools.Barcode Assembly

Introduction

Getting Started

Namespaces

Leadtools.Barcode Namespace

Assemblies