Елемент керування 1С:Друк штрихкодів
Елемент керування призначений для формування штрихкоду. Елемент керування може використовуватися лише спільно з програмними продуктами системи "1С:Підприємство 8" на робочих місцях, забезпечених Ліцензією на використання системи програм "1С:Підприємство 8". Поточна версія елемента керування — <strong>8.0.14.2</strong>.
Елемент керування призначений для формування штрихкоду. Елемент керування може використовуватися лише спільно з програмними продуктами системи "1С:Підприємство 8" на робочих місцях, забезпечених Ліцензією на використання системи програм "1С:Підприємство 8". Поточна версія елемента керування — 8.0.14.2.
- Основні можливості
- Можливості оформлення
- Властивості
- Методи
- Приклад роботи з елементом керування
- Установлення елемента керування
Основні можливості
Елемент керування дає змогу формувати штрихкоди таких форматів: EaN8, EaN13, EaN13 addOn 2, EaN13 addOn 5, ITF14, RSS14, EaN128, Code39, Code39 Full aSCII, Code93, Code128, Code16k Industrial 2 of 5, Interleaved 2 of 5, CodaBar, PDF417. Підтримується автоматичне визначення формату штрихкоду. Елементу керування можна передавати символьне значення штрихкоду як із контрольним символом, так і без нього. Є можливість вимкнення показу контрольного символу штрихкоду на результуючому зображенні штрихкоду. Для контролю повного входження смуг штрихкоду в область друку наявні властивості "мінімальна ширина" та "мінімальна висота", що містять мінімально можливу ширину й висоту області друку, у якій штрихкод може відображатися повністю.
Можливості оформлення
Текст, що відображається на поверхні штрихкоду, можна задавати програмно незалежно від вмісту самого штрихкоду. Можна змінювати шрифт, положення тексту (угорі або внизу штрихкоду), ознаку відображення тексту. Доступні для зміни колір тексту, колір фону та колір смуг штрихкоду. Фон штрихкоду може бути прозорим. Також змінюються кут повороту (дискретно на 90 градусів) штрихкоду разом із текстом, горизонтальне й вертикальне зміщення штрихкоду та розмір поля навколо друкованого штрихкоду.
Властивості
| Назва (аліас) | Тип | R | W | Опис |
|---|---|---|---|---|
| ТипКоду (CodeType) | Число | + | + | Властивість містить ідентифікатор типу штрихкоду. Може набувати одного з таких значень: 0 (тип коду — EaN8) 1 (тип коду — EaN13) 2 (тип коду — EaN128) 3 (тип коду — CODE39) 4 (тип коду — CODE128) 5 (тип коду — CODE16K) 6 (тип коду — PDF417) 7 (тип коду — Industrial2of5) 8 (тип коду — Interleaved2of5) 9 (тип коду — Code39FullaSCII) 10 (тип коду — CODE93) 11 (тип коду — ITF14) 12 (тип коду — RSS14) 13 (тип коду — CodaBar) 14 (тип коду — EaN13 addOn 2) 15 (тип коду — EaN13 addOn 5) |
| АвтоТип (Codeauto) | Булеве | + | + | Якщо ця властивість набуває значення "Істина", елемент керування намагатиметься автоматично визначати тип штрихкоду |
| МіститьКС (CodeIsRaw) | Булеве | + | + | Ця властивість містить ознаку того, що передане повідомлення містить контрольний символ |
| ВидимістьКС (CodeShowCS) | Булеве | + | + | Якщо ця властивість набуває значення "Істина", контрольний символ буде включено до рядка, що виводиться на поверхні штрихкоду (властивість має сенс лише тоді, коли передбачено виведення цього рядка) |
| Повідомлення (CodeValue) | Рядок | + | + | Властивість містить кодоване повідомлення |
| КонтрольнийСимвол (CodeCheckSymbol) | Рядок | + | - | Властивість містить контрольний символ (якщо тип штрихкоду передбачає його використання) |
| ТекстКоду (CodeText) | Рядок | + | + | Властивість містить текст, що відображається на поверхні штрихкоду (властивість має сенс лише тоді, коли передбачено виведення цього рядка). Для штрихкодів типів EaN8 та EaN13 довжина рядка має становити 8 і 13 символів відповідно. |
| Роздільники (CodeSentinel) | Число | + | + | Властивість містить висоту смуг-роздільників (лише в EaN8 та EaN13) у відсотках від висоти тексту |
| МінімальнаШирина (CodeMinWidth) | Число | + | - | Властивість містить мінімально можливу ширину області, на якій може бути відображено цей штрихкод |
| Шрифт (Font) | Шрифт | + | + | Властивість містить шрифт, що використовується під час відображення рядка на поверхні штрихкоду (властивість має сенс лише тоді, коли передбачено виведення цього рядка). |
| КолірТексту (TextColor) | Колір | + | + | Властивість містить колір, що використовується під час відображення рядка на поверхні штрихкоду (властивість має сенс лише тоді, коли передбачено виведення цього рядка). |
| ОрієнтаціяТексту (Textalign) | Число | + | + | Властивість задає спосіб розміщення рядка, що відображається на поверхні штрихкоду (властивість має сенс лише тоді, коли передбачено виведення цього рядка). Може набувати таких значень: 0 (вирівнювання тексту по центру області) 1 (вирівнювання тексту по лівому краю області) 2 (вирівнювання тексту по правому краю області) 3 (розтягнути текст за шириною області) 4,5,6 (варіанти розташування тексту, що зазвичай застосовуються на штрихкодах типів EaN8 та EaN13) |
| ПоложенняТексту (TextPosition) | Число | + | + | Властивість задає розташування рядка, що відображається на поверхні штрихкоду (властивість має сенс лише тоді, коли передбачено виведення цього рядка). Може набувати таких значень: 0 (знизу) 1 (зверху) |
| ВідображатиТекст (TextVisible) | Булеве | + | + | Властивість указує на потребу відображати текст штрихкоду на його поверхні. Актуально лише для тих типів штрихкодів, які передбачають виведення цього рядка |
| КолірФону (BgColor) | Колір | + | + | Властивість задає колір заливки фону штрихкоду. Має сенс лише тоді, коли не використовується прозорий фон. |
| ПрозорийФон (BgTransparent) | Булеве | + | + | Властивість містить ознаку використання прозорого фону |
| КолірСмуг (BarColor) | Колір | + | + | Властивість містить колір, що використовується для заливки смуг на поверхні штрихкоду |
| КутПовороту (CanvasRotation) | Число | + | + | Властивість містить кут повороту (у градусах) штрихкоду. Може набувати таких значень: 0 90 180 270 |
| ГорЗміщення (CanvasXOffset) | Число | + | + | Властивість містить значення горизонтального зміщення зображення штрихкоду |
| ВертЗміщення (CanvasYOffset) | Число | + | + | Властивість містить значення вертикального зміщення зображення штрихкоду |
| РозмірКраю (CanvasMargin) | Число | + | + | Властивість задає ширину рамки навколо зображення штрихкоду |
| ВирівнюванняКоду (Baralign) | Число | + | + | Властивість задає спосіб автоматичного розташування зображення штрихкоду. Може набувати таких значень: 0 (не використовувати автоматичне вирівнювання) 1 (по лівому краю області) 2 (по центру) 3 (по правому краю області) |
| КількістьСтовпців (ColumnCount) | Число | + | + | Властивість задає кількість стовпців штрихкоду. Актуально для PDF417. |
| КількістьРядків (RowCount) | Число | + | + | Властивість задає кількість рядків штрихкоду. Актуально для PDF417. |
| КількістьРядків (RowCount) | Число | + | + | Властивість задає кількість рядків штрихкоду. Актуально для PDF417. |
| Пропорції (aspectRatio) | Рядок | + | + | Властивість задає співвідношення висоти:ширини модулів штрихкоду. Актуально для PDF417. |
| РівеньКорекції (ECL) | Рядок | + | + | Властивість задає рівень корекції помилок. Актуально для PDF417. |
| МінімальнаВисота (CodeMinHeight) | Число | + | - | Властивість містить мінімально можливу висоту області, на якій може бути відображено цей штрихкод |
Методи
| Назва (аліас) | Параметри | Значення, що повертається | Опис |
|---|---|---|---|
| ВстановитиКолірТексту (SetTextColor) | Червоний (Число, 0-255), Зелений (Число, 0-255), Синій (Число, 0-255) |
- | Метод установлює значення властивості КолірТексту відповідно до переданих значень червоної, зеленої та синьої складових кольору |
| ВстановитиКолірСмуг (SetBarColor) | Червоний (Число, 0-255), Зелений (Число, 0-255), Синій (Число, 0-255) |
- | Метод установлює значення властивості КолірСмуг відповідно до переданих значень червоної, зеленої та синьої складових кольору |
| ВстановитиКолірФону (SetBgColor) | Червоний (Число, 0-255), Зелений (Число, 0-255), Синій (Число, 0-255) |
- | Метод установлює значення властивості КолірФону відповідно до переданих значень червоної, зеленої та синьої складових кольору |
| ВстановитиШрифт (SetFont) | Назва шрифту (Рядок), Розмір шрифту (Число), Товщина шрифту (Число), Похилий шрифт (Булеве), Перекреслений шрифт (Булеве), Підрядковий шрифт (Булеве) |
- | Метод установлює значення властивості Шрифт відповідно до переданих значень |
| ПРИМІТКА Властивості та методи також описано в довідковій системі елемента керування |
Приклад роботи з елементом керування
Змін КомпонентШК; Спроба КомпонентШК = Новий COMОб'єкт("V8.Barcod"); Виняток // Елемент керування не встановлено КомпонентШК = Невизначено; КінецьСпроби; Якщо КомпонентШК <> Невизначено Тоді Спроба // Тип коду Code128 КомпонентШК.ТипКоду = 4; КомпонентШК.Повідомлення = "Text string to be encoded"; Виняток // Помилка КінецьСпроби; КінецьЯкщо;
