PDF417 BarCode ActiveX Control

Свойства PDF417 BarCode ActiveX

DataToEncode

Данные, которые будут закодированы в штрихкод.

Синтаксис

object.DataToEncode [ = sDataToEncode ]

Возможные значения

DataToEncode Строка которая определяет штрихкод.

Свойство можно читать/записывать.

Контрольные символы и использование символа ~

Для вставки специальных символов должен использоваться символ "~". Ниже можно увидеть допустимые значения специальных символов.

~1: Не применяется.

~2: Не применяется.

~3: Этот символ допускается только в первой позиции штрихкода. Он обозначает что штрихкод содержит команды для сканера штрихкодов.

~4: Не применяется.

~5: Не применяется.

~6: Не применяется.

~7NNNNNN: Определяет используемый Extended Channel. NNNNNN - это значение в диапазоне 000000 - 811799. Например: ~7000010 означает Extended Channel 10. Extended Channel Interpretation (ECI) - используется для изменения кодировки, применяемой по умолчанию. Этот механизм позволяет символам из других кодовых страниц (Арабской, Кириллицы, Греческой и т.д.) быть правильно представленным в приложении пользователя. ECI может применяться только со сканерами, которые позволяют передавать идентификаторы символов.

~xNN: Представляет шестнадцатиричное значение of NN, например если следует комбинация "~xA7", она будет заменена на шестнадцатиричное значение A7.

~~: Представляет символ "~". Например, "~~R" означает не CR, а два символа "~" и "R".

~R: Представляет символ возврата каректи (CR).

~N: Представляет символ новой строки (LF).

~T: Представляет символ табуляции (HT).

CompactionMode

Возвращает/устанавливает режим кодировки PDF417 штрихкода.

Синтаксис

object.CompactionMode [ = eCompactionMode ]

Возможные значения

eCompactionMode Значение определяющее режим кодировки PDF417 штрихкода

Значение Константа Описание

0 cmAuto Используется наиболее оптимальное режимов кодировки. Благодаря изменению режимов кодировки, достигается наиболее оптимальный размер PDF417 штрихкода.

1 cmText Этот режим кодировки включает все печатаемые ASCII символыs (т.е. значения от 32 до 126) и три контрольных ASCII символа: HT или табуляция (ASCII значение 9), LF или новая строка (ASCII значение 10), и CR или возврат каретки (ASCII значение 13). Этот режим кодировки использует 2 символа на одно кодовое слово.

2 cmNumeric Этот режим кодировки должен использоваться для длинных строк содержащих последовательность чисел.

3 cmByte Этот режим допускает кодирование последовательности байт.

Свойство можно читать/записывать.

ErrorCorrectionLevel

Возвращает/устанавливает уровень коррекции ошибок PDF417 штрихкода.

Синтаксис

object.ErrorCorrectionLevel [ = eErrorCorrectionLevel ]

Возможные значения

eErrorCorrectionLevel Значение определяющее уровень коррекции ошибок PDF417

Значение Константа Всего корректирующих символов

0 ecl_0 2

1 ecl_1 4

2 ecl_2 8

3 ecl_3 16

4 ecl_4 32

5 ecl_5 64

6 ecl_6 128

7 ecl_7 256

8 ecl_8 512

9 eclAuto Определяет минимально рекомендуемый уровень коррекции.

Свойство можно читать/записывать.

Примечания

Коррекция ошибок может использоваться для компенсации дефектов этикетки со штрихкодом и ошибок при декодировании. Для любого уровня коррекции, определенное количество символов коррекции встраивается в PDF417 штрихкод.

DataColumns

Возвращает/устанавливает количество столбцов данных в PDF417 матрице. Это значение может быть от 1 до 30. Большее количество столбцов требует большей ширины PDF417 штрихкода.
Если свойство DataRows равно 0, то количество строк вычисляется автоматически, в зависимости от количества кодируемых данных и от количества столбцов.
Точно так же, если DataColumns равно нулю, то необходимое количество столбцов вычисляется автоматически.
Свойства DataColumns и DataRows не могут быть равными нулю одновременно.
Если DataColumns и DataRows не равны нулю, то PDF417 будет пытыться закодировать данные, используя данные параметры.

Синтаксис

object.DataColumns [ = iDataColumns ]

Возможные значения

iDataColumns Целое определяющее свойство DataColumns

Свойство можно читать/записывать.

DataRows

Возвращает/устанавливает количество строк PDF417 матрице. Это значение может быть в диапазоне от 3 до 90.

Синтаксис

object.DataRows [ = iDataRows ]

Возможные значения

iDataRows Целое определяющее свойство DataRows

Свойство можно читать/записывать.

CompactPDF

Если это свойство равно True, то PDF417 штрихкод будет отрисован в компактном режиме. Вы должны иметь ввиду, что не все сканера поддерживают компактный PDF417.

Синтаксис

object.CompactPDF [ = bCompactPDF ]

Возможные значения

bCompactPDF Логическое определяющее свойство CompactPDF

Свойство можно читать/записывать.

Y2XRatio

Это свойство определяет отношение y-dimension к x-dimension. Минимально рекомендуемое значение 3. Обычно это свойство устанавливают равным 4.

Синтаксис

object.Y2XRatio [ = rY2XRatio ]

Возможные значения

rY2XRatio Значение определяющее отношение y к x.

Свойство можно читать/записывать.

Orientation

Определяет ориентацию штрихкода.

Синтаксис

object.Orientation [ = eOrientation ]

Возможные значения

Orientation Значение определяющее свойство Orientation.
Допустимы следующие значения 0, 90, 180 и 270

Свойство можно читать/записывать.

Transparent

Определяет прозрачный или нет должен быть фон штрихкода.

Синтаксис

object.Transparent [ = bTransparent ]

Возможные значения

bTransparent Boolean определяющее свойство Transparent
Если значение равно False, тогда фон штрихкода будет закрашен цветом BackColor.

Свойство можно читать/записывать.

BackColor

Цвет самого штрихкода.

Синтаксис

object.BackColor [ = sColor ]

Возможные значения

sColor Значение определяющее свойство BackColor

Свойство можно читать/записывать.

Примечания

Свойство BackColor не имеет смысла, если свойство Transparent установлено в True.

ForeColor

Цвет самого штрихкода.

Синтаксис

object.ForeColor [ = sColor ]

Возможные значения

sColor Значение определяющее свойство ForeColor

Свойство можно читать/записывать.

QuietZone Property

Возвращает/устанавливает значение определяющее включать или нет зону успокоения (quiet zone) в PDF417 штрихкод. PDF417 должен иметь зону успокоения со всех четырех сторон.

Синтаксис

object.QuietZone [ = bQuietZone ]

Возможные значения

bShowQuietZone Логическое определяющее свойство QuietZone

Свойство можно читать/записывать.

Примечания

Зона успокоения это небольшая площадь пустого пространства вокруг штрихкода.

AlignH

Возвращает/устанавливает горизонтальное выравнивание.

Синтаксис

object.AlignH [ = eAlignH ]

Возможные значения

eAlignH Значение определяющее свойство AlignH

Значение Константа Описание

0 hPDFLeft влево

1 hPDFCenter по центру

2 hPDFRight вправо

Свойство можно читать/записывать.

AlignV

Возвращает/устанавливает вертикальное выравнивание.

Синтаксис

object.AlignV [ = eAlignV ]

Возможные значения

eAlignV Значение определяющее свойство AlignV

Значение Константа Описание

0 vPDFTop вверх

1 vPDFCenter по центру

2 vPDFBottom вниз

Свойство можно читать/записывать.

LastError

Возвращает код последней ошибки.

Синтаксис

object.LastError

Возможные значения

hLastError Значение получающее свойство LastError

Свойство можно только читать.

LastErrorInfo

Возвращает описание последней ошибки, или пустую строку, если ошибок нет.

Синтаксис

object.LastErrorInfo

Возможные значения

sLastErrorInfo Строка получающая свойство LastErrorInfo

Свойство можно только читать.