Method: CopyToClipboard - Synatx 3

Copies a barcode symbol to the system clipboard. The barcode symbol is specified in the parameters of this method.

Syntax:

type

{ Defined in the pCore1D unit }

TDisplayText = (dtNone, dtBarcode, dtFullEncoded);

{ Defined in the pCore1D unit }

TTextPosition = (tpTopIn, tpTopOut, tpBottomIn, tpBottomOut);

{ Defined in the pCore1D unit }

TTextAlignment = (taLeft, taCenter, taRight, taJustify, taLeftQuietZone, taCenterQuietZone, taRightQuietZone, taJustifyQuietZone, taCustom);

function CopyToClipboard(Data: AnsiString; AutoCheckDigit: Boolean; BarColor, SpaceColor: TColor; BarcodeTextDefine: TBarcodeTextDefine; Ratio: Double; Module: Integer = 0; Height: Integer = 0; Angle: Integer = 0): Integer; overload; virtual;

Description:

Copies a barcode symbol that is specified in the parameters of this method to the system clipboard.

Parameters:

• Data: AnsiString; Specifies the barcode text. It is of type AnsiString, so you can specifiy the barcode text in AnsiString format. The method is available only for the Delphi/C++ Builder 2009 or later.

  For the TBarcode1D_Code128 and the TBarcode1D_EAN128 components, you can use the method to encode a block of binary (bytes) data under Delphi/C++ Builder 2009 or later. If you want to encode a block of binary (bytes) data into a barcode symbol under Delphi/C++ Builder 2007 or early, please use the CopyToClipboard (Syntax 2) overloading method. Note, the "\" character is used as a escape prefix, so if you want to encode the "\" character, please use the "\\" instead of it.

  For the TBarcode1D_OneCode component, first 20 characters are the Tracking (It is right padded with zeroes to 20 characters), then come the Routing.

  For the TBarcode1D_FIM component, it is single character that denotes the FIM type, form "A" to "E", the "E" character dnotes an empty barcode symbol.

  For the TBarcode1D_Patch component, it is single character that denotes the Ptach type, and it can be set to "0", "1", "2", "3", "4", "6", and "T", the "0" character dnotes an empty barcode symbol.

  For the TBarcode1D_Code32 component, First "A" character does not need to be entered in the parameter. Also, for the TBarcode1D_PZN component, First "PZN" characters do not need to be entered in the parameter.

  See also the "Data" property.

• AutoCheckDigit: Boolean; Specifies whether the check digit should be automatically appended to the barcode symbol.

  See also the "AutoCheckDigit" property.

• BarColor: TColor; Specifies the color for all bars in the barcode symbol.

  See also the "BarColor" property.

• SpaceColor: TColor; Specifies the color for all spaces in the barcode symbol.

  If the human readable text is represent, the color will be used as its background color (the foreground color is specified using the TextFont field of the BarcodeTextDefine parameter). For TBarcode1D_ITF6, TBarcode1D_ITF14, and TBarcode1D_ITF16 components, the left spacing and the right spacing will be represented using the color. For TBarcode1D_UPCE, TBarcode1D_UPCE0, TBarcode1D_UPCE1, TBarcode1D_UPCA, TBarcode1D_EAN2, TBarcode1D_EAN5, TBarcode1D_EAN8, and TBarcode1D_EAN13 components, if the human readable text is represented, and the TextAlignment field of the BarcodeTextDefine parameter is set to taCustom, the left and right quiet zones, left quietzone spacing and right quiet zone spacing will be represented using the color. In other words, the parameter specify the background color for entire barcode symbol.

  See also the "SpaceColor" property.

• BarcodeTextDefine: TBarcodeTextDefine; Specifies whether to display the human readable text and how to display the human readable text. The record is defined in the pBarcode1D unit.

  See also the TBarcodeTextDefine record.

• Ratio: Double; Specifies ratio between a wide bar (or space) and a narrow bar (or space) in the barcode symbol. The normal values are from 2.0 to 3.0. If the parameter is less than or equal to zero, the method fails, and the return value is -2.

  See also the "Ratio" property.

• Module: Integer; Specifies the module width in logical dots or pixels in the horizontal direction, it is the width of the smallest bar (or space) in the barcode symbol. If the parameter isn't provided or it is set to zero, the value of "Module" property will be used.

  See also the "Module" property.

• Height: Integer; Specifies the distance between the top and bottom of a barcode symbol in modules. If the human readable text is displayed, the height of the human readable text and its vertical spacing (TextVSpacing) are included.

  If the parameter isn't provided or its value is set to zero, the value of Height property will be used.

  For TBarcode1D_ITF6, TBarcode1D_ITF14, and TBarcode1D_ITF16 barcode components, the height of the top and bottom bearer bars (BearerWidth) are included too.

  If the human readable text is displayed, and it exceeds the barcode symbol in vertical direction, the excess isn't included.

  See also the "Height" property.

  Note: If the parameter is less than zero, its absolute value specifies the height in pixels in the vertical direction.

• Angle: Integer; Specifies an angle in degrees to rotate the barcode symbol. It defaults to 0 if the Angle is not provided, meaning left to right horizontal direction.

Return:

• If the method succeeds, the return value is zero.
• If the Barcode string length is invalid, the return value is -1.
• If the Ratio parameter is less than or equal to zero, the return value is -2.
• If there is any invalid character in the Barcode string, the return value is the position index of first invalid character, the index 1 denotes that the first character is invalid character.

See diagram:

Note:

The overloading method is available only for the Delphi/C++ Builder 2009 or later.

Contents