LEADTOOLSバーコード(Leadtools.Barcodeアセンブリ)

フレームを表示

GetDefaultOptionsメソッド(BarcodeWriter)








そのオプションを取得するためにバーコードバーコード体系(または型)を指定するBarcodeSymbology列挙体メンバ。
指定されたシンボルのためにデフォルトの書き込みオプションを取得します。
構文
public BarcodeWriteOptions GetDefaultOptions( 
   BarcodeSymbology symbology
)
'Declaration
 
Public Function GetDefaultOptions( _
   ByVal symbology As BarcodeSymbology _
) As BarcodeWriteOptions
'Usage
 
Dim instance As BarcodeWriter
Dim symbology As BarcodeSymbology
Dim value As BarcodeWriteOptions
 
value = instance.GetDefaultOptions(symbology)
public BarcodeWriteOptions GetDefaultOptions( 
   BarcodeSymbology symbology
)
- (LTBarcodeWriteOptions *)defaultOptionsForSymbology:(LTBarcodeSymbology)symbology
public BarcodeWriteOptions getDefaultOptions(BarcodeSymbology symbology)
 function Leadtools.Barcode.BarcodeWriter.GetDefaultOptions( 
   symbology 
)
public:
BarcodeWriteOptions^ GetDefaultOptions( 
   BarcodeSymbology symbology
) 

パラメーター

シンボル
そのオプションを取得するためにバーコードバーコード体系(または型)を指定するBarcodeSymbology列挙体メンバ。

戻り値

BarcodeWriteOptionsは、シンボルで指定されている型のバーコードを書き込むとき、使うデフォルトの書き込みオプションとして、このBarcodeWriterにより用いられるオブジェクトを引き出しました。
解説

LEADTOOLSは、バーコードを書き込むとき、追加のオプションを使用に提供します。これらのオプションは、パラメータを微調整するか、特定の種類のバーコードに特有である追加のプレ既知情報を提供するのに用いられます。これらのオプションの抽象基本クラスはBarcodeWriteOptionsです。LEADTOOLSは、派生クラスを各々のシンボル(またはバーコード体系のグループ)に提供します。詳細については、「BarcodeWriteOptions」を参照してください。

BarcodeWriterクラスには、各バーコード体系(または共通バーコード体系のグループ)のデフォルトオプションが含まれます。これらのオプションを取得するには、対象のバーコード体系を渡してGetDefaultOptionsメソッドを呼び出します。その後で、返されたBarcodeWriteOptionsのメンバを変更できます(または、適切な派生クラスにキャストしてからそのメンバを変更します)。ユーザーがオプションパラメーターのためにnullまたは何もを使用して特定のオプションなしでWriteBarcodeメソッドを呼び出さないとき、これらのデフォルトオプションはBarcodeWriterにより用いられるでしょう。

派生BarcodeWriteOptionsクラスの1つのインスタンスを作成することもできて、WriteBarcodeで直接それを使うこともできます。

BarcodeSymbology.Unknownは、すべてのバーコードを読むためにエンジンを指示するのに用いられる特別な型です。それには関連づけられる書き込みオプションクラスがなくて、このメソッドで使われるべきでありません、さもなければ、例外はスローされます。

サンプル

このサンプルは、標準的な1次元1Dバーコード(UPC-A、UPC-Eその他)を書き込むとき使われるデフォルトオプションを取得する方法を示して、それからバーコードを書き込む前に、変更します

Copy Code  
Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.Forms
Imports Leadtools.Barcode
Imports Leadtools.ImageProcessing

      
Public Sub BarcodeWriter_GetDefaultOptionsExample()
   Dim imageFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "MyBarcode.tif")
   Dim engine As New BarcodeEngine()
   Dim writer As BarcodeWriter = engine.Writer

   ' Create an image to write the barcodes to
   Dim resolution As Integer = 300
   Dim width As Integer = CType(resolution * 8.5, Integer)
   Dim height As Integer = CType(resolution * 11.0, Integer)
   Using image As RasterImage = RasterImage.Create(width, height, 1, resolution, RasterColor.FromKnownColor(RasterKnownColor.White))
      ' Write a UPC-A barcode with default options
      Dim upcaBarcode As BarcodeData = BarcodeData.CreateDefaultBarcodeData(BarcodeSymbology.UPCA)
      upcaBarcode.Bounds = New LogicalRectangle(0, 0, 400, 100, LogicalUnit.Pixel)
      writer.WriteBarcode(image, upcaBarcode, Nothing)

      ' Now change the default options to not show the barcode text when writing
      Dim oneDWriteOptions As OneDBarcodeWriteOptions = DirectCast(writer.GetDefaultOptions(BarcodeSymbology.UPCA), OneDBarcodeWriteOptions)
      oneDWriteOptions.TextPosition = BarcodeOutputTextPosition.None

      ' Write the same barcode with new default options
      upcaBarcode.Bounds = New LogicalRectangle(0, 200, 400, 100, LogicalUnit.Pixel)
      writer.WriteBarcode(image, upcaBarcode, Nothing)

      ' Save the image to disk
      Using codecs As New RasterCodecs()
         codecs.Save(image, imageFileName, RasterImageFormat.CcittGroup4, 1)
      End Using
   End Using
End Sub

Public NotInheritable Class LEAD_VARS
Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
using Leadtools;
using Leadtools.Codecs;
using Leadtools.Forms;
using Leadtools.Barcode;
using Leadtools.ImageProcessing;

      
public void BarcodeWriter_GetDefaultOptionsExample()
{
   string imageFileName = Path.Combine(LEAD_VARS.ImagesDir, "MyBarcode.tif");
   BarcodeEngine engine = new BarcodeEngine();
   BarcodeWriter writer = engine.Writer;

   // Create an image to write the barcodes to
   int resolution = 300;
   int width = (int)(resolution * 8.5);
   int height = (int)(resolution * 11.0);
   using(RasterImage image = RasterImage.Create(width, height, 1, resolution, RasterColor.FromKnownColor(RasterKnownColor.White)))
   {
      // Write a UPC-A barcode with default options
      BarcodeData upcaBarcode = BarcodeData.CreateDefaultBarcodeData(BarcodeSymbology.UPCA);
      upcaBarcode.Bounds = new LogicalRectangle(0, 0, 400, 100, LogicalUnit.Pixel);
      writer.WriteBarcode(image, upcaBarcode, null);

      // Now change the default options to not show the barcode text when writing
      OneDBarcodeWriteOptions oneDWriteOptions = writer.GetDefaultOptions(BarcodeSymbology.UPCA) as OneDBarcodeWriteOptions;
      oneDWriteOptions.TextPosition = BarcodeOutputTextPosition.None;

      // Write the same barcode with new default options
      upcaBarcode.Bounds = new LogicalRectangle(0, 200, 400, 100, LogicalUnit.Pixel);
      writer.WriteBarcode(image, upcaBarcode, null);

      // Save the image to disk
      using(RasterCodecs codecs = new RasterCodecs())
      {
         codecs.Save(image, imageFileName, RasterImageFormat.CcittGroup4, 1);
      }
   }
}

static class LEAD_VARS
{
public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}
using Leadtools;
using Leadtools.Codecs;
using Leadtools.Barcode;
using Leadtools.ImageProcessing;

      
public async Task BarcodeWriter_GetDefaultOptionsExample()
{
   string imageFileName = @"MyBarcode.tif";
   BarcodeEngine engine = new BarcodeEngine();
   BarcodeWriter writer = engine.Writer;

   // Create an image to write the barcodes to
   int resolution = 300;
   int width = (int)(resolution * 8.5);
   int height = (int)(resolution * 11.0);
   using(RasterImage image = RasterImage.Create(width, height, 1, resolution, RasterColorHelper.FromKnownColor(RasterKnownColor.White)))
   {
      // Write a UPC-A barcode with default options
      BarcodeData upcaBarcode = BarcodeData.CreateDefaultBarcodeData(BarcodeSymbology.UPCA);
      upcaBarcode.Bounds = LeadRectHelper.Create(0, 0, 400, 100);
      writer.WriteBarcode(image, upcaBarcode, null);

      // Now change the default options to not show the barcode text when writing
      OneDBarcodeWriteOptions oneDWriteOptions = writer.GetDefaultOptions(BarcodeSymbology.UPCA) as OneDBarcodeWriteOptions;
      oneDWriteOptions.TextPosition = BarcodeOutputTextPosition.None;

      // Write the same barcode with new default options
      upcaBarcode.Bounds = LeadRectHelper.Create(0, 200, 400, 100);
      writer.WriteBarcode(image, upcaBarcode, null);

      // Save the image to disk
      using(RasterCodecs codecs = new RasterCodecs())
      {
         StorageFile saveFile = await Tools.AppLocalFolder.CreateFileAsync(imageFileName);
         await codecs.SaveAsync(image, LeadStreamFactory.Create(saveFile), RasterImageFormat.CcittGroup4, 1);
      }
   }
}
using Leadtools;
using Leadtools.Codecs;
using Leadtools.Forms;
using Leadtools.Barcode;
using Leadtools.ImageProcessing;
using Leadtools.Examples;

public void BarcodeWriter_GetDefaultOptionsExample(RasterImage image, Stream outStream)
{
   BarcodeEngine engine = new BarcodeEngine();
   BarcodeWriter writer = engine.Writer;
   // Create an image to write the barcodes to
   // Write a UPC-A barcode with default options
   BarcodeData upcaBarcode = BarcodeData.CreateDefaultBarcodeData(BarcodeSymbology.UPCA);
   upcaBarcode.Bounds = new LogicalRectangle(0, 0, 400, 100, LogicalUnit.Pixel);
   writer.WriteBarcode(image, upcaBarcode, null);

   // Now change the default options to not show the barcode text when writing
   OneDBarcodeWriteOptions oneDWriteOptions = writer.GetDefaultOptions(BarcodeSymbology.UPCA) as OneDBarcodeWriteOptions;
   oneDWriteOptions.TextPosition = BarcodeOutputTextPosition.None;

   // Write the same barcode with new default options
   upcaBarcode.Bounds = new LogicalRectangle(0, 200, 400, 100, LogicalUnit.Pixel);
   writer.WriteBarcode(image, upcaBarcode, null);

   // Save the image to disk
   RasterCodecs codecs = new RasterCodecs();
   codecs.Save(image, outStream, RasterImageFormat.CcittGroup4, 1);
}
Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.Forms
Imports Leadtools.Barcode
Imports Leadtools.ImageProcessing

Public Sub BarcodeWriter_GetDefaultOptionsExample(ByVal image As RasterImage, ByVal outStream As Stream)
  Dim engine As BarcodeEngine = New BarcodeEngine()
  Dim writer As BarcodeWriter = engine.Writer
  ' Create an image to write the barcodes to
  ' Write a UPC-A barcode with default options
  Dim upcaBarcode As BarcodeData = BarcodeData.CreateDefaultBarcodeData(BarcodeSymbology.UPCA)
  upcaBarcode.Bounds = New LogicalRectangle(0, 0, 400, 100, LogicalUnit.Pixel)
  writer.WriteBarcode(image, upcaBarcode, Nothing)

  ' Now change the default options to not show the barcode text when writing
  Dim oneDWriteOptions As OneDBarcodeWriteOptions = TryCast(writer.GetDefaultOptions(BarcodeSymbology.UPCA), OneDBarcodeWriteOptions)
  oneDWriteOptions.TextPosition = BarcodeOutputTextPosition.None

  ' Write the same barcode with new default options
  upcaBarcode.Bounds = New LogicalRectangle(0, 200, 400, 100, LogicalUnit.Pixel)
  writer.WriteBarcode(image, upcaBarcode, Nothing)

  ' Save the image to disk
  Dim codecs As RasterCodecs = New RasterCodecs()
  codecs.Save(image, outStream, RasterImageFormat.CcittGroup4, 1)
End Sub
必要条件

ターゲットプラットホーム

参照

参照

BarcodeWriterクラス
BarcodeWriterメンバ

Leadtools.Barcodeは、バーコードモジュールのライセンスと、解除キーが必要です。詳細は、以下を参照してください。LEADTOOLSツールキット機能