Method: Save

Save current barcode symbol in the barcode component to an image file. The barcode component is specified by the Barcode2D property.

Syntax:

function Save(FilePath: string): Integer; virtual;

Description:

The method saves the barcode symbol to the image file. The barcode symbol is defined in the barcode component that's specified by the Barcode2D property. Also, the TImage component isn't required in the Image property of the barcode component.

For the TBarcode2D_CCA, TBarcode2D_CCB, and TBarcode2D_CCC barcode components, if the Linear property is set, the 2D symbol and the linear symbol are assembled to generate an EAN.UCC composite barcode symbol. Only the 2D portion will be saved in the image file now.

An OnSave event will occur before save the barcode symbol to picture file. And an OnSaved event will occur after the barcode symbol is saved.

Parameters:

• FilePath: String; Specifies the file path and name for the image file.

Return:

This method can return one of these values (these consts are defined in the pSave2D unit):

• ERROR_OK (0): The method invocation succeeded.
• ERROR_NO_BARCODE_COMPONENT (1): The method invocation failed because the Barcode2D property is not link to a barcode component.
• ERROR_INVALID_BARCODE (2): The method invocation failed. Because the length of Barcode or Data (only for Delphi/C++ Builder 2009 or later) property value is invalid in the barcode component, corresponding to the OnInvalidLength or OnInvalidDatalength (only for Delphi/C++ Builder 2009 or later) event of barcode component will occur. Or because there is any invalid character in the Barcode or Data (only for Delphi/C++ Builder 2009 or later) property value, corresponding to the OnInvalidChar or OnInvalidDataChar (only for Delphi/C++ Builder 2009 or later) event of barcode component will occur.
• ERROR_WRITE_PICTURE (3): The method invocation failed because the picture file write error. Perhaps the file system fulls, or the access is denied.

Contents