Справочник по модулю HPDFBarcode

Главная Содержание THPDFPage.DrawBarcode

Изучите THPDFBarcode, перечисления параметров штрихкода, простые записи полос и функции кодирования Simple*

Используйте THPDFPage.DrawBarcode для прямого вывода на страницу PDF, THPDFBarcode для рендеринга в VCL TCanvas и функции Simple*, когда приложению нужна созданная последовательность полос до рисования

THPDFBarcode

THPDFBarcode является потомком TComponent, который выводит настроенный штрихкод на canvas VCL и при необходимости рисует читаемую текстовую подпись

Элемент	Использование
`Assign`	Копирует конфигурацию штрихкода из другого persistent-объекта
`DrawBarcode`	Рисует полосы настроенного штрихкода на переданном TCanvas
`DrawText`	Рисует необязательную текстовую подпись на переданном TCanvas
`CanvasHeight`	Возвращает повернутую высоту рисования, необходимую для настроенных Width, Height и Angle
`CanvasWidth`	Возвращает повернутую ширину рисования, необходимую для настроенных Width, Height и Angle

Опубликованные свойства

Компонент публикует настройки макета, типа штрихкода, контрольной суммы, цвета, текстовой подписи и уведомления об изменении

Свойство	Использование
`Height`, `Width`	Задает высоту рисования штрихкода и читает или назначает рассчитанную ширину
`Text`	Передает содержимое штрихкода как AnsiString
`Вверх`, `Left`	Задает начало координат canvas для вывода штрихкода
`Modul`	Задает базовую ширину модуля, используемую при рисовании полос
`Ratio`	Задает отношение широких и узких полос для поддерживаемых символик
`Typ`	Выбирает тип штрихкода по порядковому значению THPDFBarcodeType
`Checksum`, `CheckSumMethod`	Включает вывод контрольной суммы и выбирает csmNone или csmModulo10
`Angle`	Поворачивает отрисованный штрихкод
`ShowText`, `ShowTextFont`, `ShowTextPosition`	Управляет выводом читаемого текста, используемым шрифтом и расположением подписи
`Color`, `ColorBar`	Задает цвет фона и цвет полос
`OnChange`	Получает TNotifyEvent, когда setter свойства изменяет состояние штрихкода

Типы и параметры штрихкодов

Тип	Значения
`THPDFBarcodeType`	`bcCode_2_5_interleaved`, `bcCode_2_5_industrial`, `bcCode_2_5_matrix`, `bcCode39`, `bcCode39Extended`, `bcCode128A`, `bcCode128B`, `bcCode128C`, `bcCode93`, `bcCode93Extended`, `bcCodeMSI`, `bcCodePostNet`, `bcCodeCodabar`, `bcCodeEAN8`, `bcCodeEAN13`, `bcCodeUPC_A`, `bcCodeUPC_E0`, `bcCodeUPC_E1`, `bcCodeUPC_Supp2`, `bcCodeUPC_Supp5`, `bcCodeEAN128A`, `bcCodeEAN128B`, `bcCodeEAN128C`
`THPDFBarcodeOption`	`bcoNone`, `bcoCode`, `bcoTyp`, `bcoBoth`
`THPDFShowTextPosition`	`stpTopLeft`, `stpTopRight`, `stpTopCenter`, `stpBottomLeft`, `stpBottomRight`, `stpBottomCenter`
`THPDFCheckSumMethod`	`csmNone`, `csmModulo10`
`THPDFBarLineType`	`white`, `black`, `black_half`

Простые записи полос

Простые функции кодирования возвращают созданные полосы через TSimpleBarArray, массив записей TSimpleBarcodeBar

Запись	Поля
`TSimpleBarcodeBar`	Width содержит вклад ширины модуля, а Filled показывает, является ли сегмент напечатанной полосой
`TSimpleBarArray`	Динамический массив значений TSimpleBarcodeBar, заполняемый функциями Simple*

Простые функции кодирования

Каждая функция имеет сигнатуру function Name(const Text: AnsiString; var Bars: TSimpleBarArray): Integer и возвращает общую ширину созданных полос

Группа	Функции
Code 2/5	`SimpleCode25Interleaved`, `SimpleCode25Industrial`, `SimpleCode25Matrix`
Code 39 and Code 93	`SimpleCode39`, `SimpleCode39Extended`, `SimpleCode93`, `SimpleCode93Extended`
Code 128 and EAN-128	`SimpleCode128A`, `SimpleCode128B`, `SimpleCode128C`, `SimpleEAN128A`, `SimpleEAN128B`, `SimpleEAN128C`
Розница и почта	`SimpleEAN8`, `SimpleEAN13`, `SimpleUPC_A`, `SimpleUPC_E0`, `SimpleUPC_E1`, `SimpleUPC_Supp2`, `SimpleUPC_Supp5`, `SimplePostNet`
Другие поддерживаемые символики	`SimpleMSI`, `SimpleCodebar`

Пример

var
  Bars: TSimpleBarArray;
  TotalWidth: Integer;
begin
  TotalWidth := SimpleCode128B('ABC-123', Bars);
end;

См. также