←Select platform

LoadOptions(string) Method

Summary
Loads the default read options from the specified XML file for this BarcodeReader.
Syntax
C#
C++/CLI
Python
public void LoadOptions( 
   string fileName 
) 
public: 
void LoadOptions(  
   String^ fileName 
)  
def LoadOptions(self,fileName): 

Parameters

fileName
The XML file containing the data.

Remarks

The load/save methods are provided as helper methods for the user. The BarcodeEngine, BarcodeReader and BarcodeWriter do not use these methods internally.

The default read options can be retrieved using the GetDefaultOptions or GetAllDefaultOptions methods. You can then change the values of the BarcodeReadOptions object returned (or cast it back to the appropriate derived class). These options are used by the ReadBarcode and ReadBarcodes methods when no explicit options are passed by the user.

To save the default options to an XML file, use BarcodeReader.SaveOptions(string fileName).

To save and load data to an XML stream, use BarcodeReader.SaveOptions(Stream stream) and BarcodeReader.LoadOptions(Stream stream).

Example

This example shows how to change, save and then load the options of a BarcodeReader object.

C#
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Barcode; 
using Leadtools.ImageProcessing; 
 
 
public void BarcodeReader_LoadSaveOptionsExample() 
{ 
   string xmlFileName = Path.Combine(LEAD_VARS.ImagesDir, "MyReadOptions.xml"); 
 
   BarcodeEngine engine1 = new BarcodeEngine(); 
   BarcodeReader reader1 = engine1.Reader; 
 
   // Show a few of the default options 
   ShowReaderOptions("Default options 1:", reader1); 
 
   // Change some options 
   OneDBarcodeReadOptions oneDReadOptions = reader1.GetDefaultOptions(BarcodeSymbology.UPCA) as OneDBarcodeReadOptions; 
   oneDReadOptions.SearchDirection = BarcodeSearchDirection.HorizontalAndVertical; 
   QRBarcodeReadOptions qrReadOptions = reader1.GetDefaultOptions(BarcodeSymbology.QR) as QRBarcodeReadOptions; 
   qrReadOptions.EnableDoublePass = true; 
 
   // Show them 
   ShowReaderOptions("New options 1:", reader1); 
 
   // Save the options to an XML file 
   reader1.SaveOptions(xmlFileName); 
 
   // Now create another BarcodeReader 
   // We could use the same one, but this example will show that changing the options 
   // for one BarcodeReader will not change it in any other in the application 
 
   BarcodeEngine engine2 = new BarcodeEngine(); 
   BarcodeReader reader2 = engine2.Reader; 
 
   // Show a few of the default options, should be the same as the first default options 
   ShowReaderOptions("Default options 2:", reader2); 
 
   // Load the options we just saved 
   reader2.LoadOptions(xmlFileName); 
 
   // Show them, should be the same as the new options in reader1 
   ShowReaderOptions("Loaded options 2:", reader2); 
} 
 
private void ShowReaderOptions(string message, BarcodeReader reader) 
{ 
   Console.WriteLine(message); 
   OneDBarcodeReadOptions oneDReadOptions = reader.GetDefaultOptions(BarcodeSymbology.UPCA) as OneDBarcodeReadOptions; 
   Console.WriteLine("OneDBarcodeReadOptions.SearchDirection: {0}", oneDReadOptions.SearchDirection); 
   QRBarcodeReadOptions qrReadOptions = reader.GetDefaultOptions(BarcodeSymbology.QR) as QRBarcodeReadOptions; 
   Console.WriteLine("QRBarcodeReadOptions.EnableDoublePass: {0}", qrReadOptions.EnableDoublePass); 
   Console.WriteLine("---------------"); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
} 
Requirements

Target Platforms

Help Version 22.0.2023.5.9
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Barcode Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.