Методы DataMatrix ActiveX
|
AboutBox
Открывает окно "О программе".
Синтаксис
object.AboutBox()
Возвращаемое значение
Не возвращает значение.
|
ShowProperties
Отрывает окно свойств DataMatrix ActiveX.
Синтаксис
object.ShowProperties()
Возвращаемое значение
Не возвращает значение.
|
SaveToImageFile
Сохраняет изображение штрихкода в файл.
Синтаксис
object.SaveToImageFile(cx, cy, sFileName, [lRes,] [dm])
Параметры
| cx | Вещественное значение определяет ширину картинки штрихкода. |
| cy | Вещественное значение определяет высоту картинки штрихкода. |
| sFileName | Строка определяет имя файла. |
| lRes | Необязательное (по умолчанию 0). Определяет разрешение картинки. |
| dm | Необязательное (по умолчанию dmPixels). Определяет единицы измерения, которые используются для задания cx и cy. См. Примечание. |
Возвращаемое значение
Не возвращает значение.
Примечание
Формат, в котором будет сохранен файл зависит от расширения имени файла. Например, если задать sFileName как "img1.jpg", то штрихкод будет сохранен в JPEG.
Допускаются такие расширения - "wmf", "emf", "bmp", "jpg", "jpeg", "gif", "tiff", "png".
Параметр dm parameter может иметь следующие значения:
dmMils = 0, mils(0.001 inches)
dmInches = 1, inches
dmMM = 2, millimeters
dmPixels = 3, pixels
Если размер изображения (cx, cy) задается не в пикселах, его реальный размер будет вычисляться
использую разрешение картинки - lRes.
Внимание! Для нормальной работы этой функции необходимо наличие библиотеки GDI+
(gdiplus.dll) на вашем PC, эта библиотека поставляется в составе Windows XP и выше.
Если у вас нет такой библиотеки, то вы можете загрузить ее здесь, а затем скопировать
ее в папку ../Windows/System32/.
Примеры
'1. 'Сохранить изображение DataMatrix штрихкода в JPEG формат. Размер изображения будет 100x100 точек, разрешение 96 dpi.
Call DataMatrixCtrl1.SaveToImageFile(100, 100, "c:\datamatrix.gif")
'2. 'Сохранить изображение DataMatrix штрихкода в JPEG формат. Размер изображения будет 30x30 мм, разрешение 300 dpi.
Call DataMatrixCtrl1.SaveToImageFile(30, 30, "c:\datamatrix.gif", 300, dmMM)
|
PartialWritePicture Method
Сохраняет изображение штрихкода в существующий файл картинки. При этом штрихкод может занимать только необходимую
часть файла.
Синтаксис
object.PartialWritePicture(sFileName, x, y, width, height)
Параметры
| sFileName | Строка определяющая имя файла. |
| x | Целое определяющее X координату штрихкода. |
| y | Целое определяющее Y координату штрихкода. |
| width | Целое определяющее ширину штрихкода. |
| height | Целое определяющее высоту штрихкода. |
Возвращаемое значение
Не возвращает значение.
Примечание
Image файл определяемый параметром sFileName может быть следующих форматов "bmp", "jpg", "jpeg", "gif",
"tiff" и "png".
Examples
Call DataMatrix.PartialWritePicture("c:\1.jpg", 10, 10, 60, 60)

Используя этот метод, можно добавить к любому вашему image файлу штрихкод, который может использоваться для
идентификации файла или для иных целей.
|
CopyToClipboard
Копирует изображение DataMatrix штрихкода в буфер обмена. После этого вы можете использовать Ctrl+V для вставки штрихкода.
Синтаксис
object.CopyToClipboard(cx, cy)
Параметры
| cx | Целое значение определяющее ширину штрихкода |
| cy | Целое значение определяющее высоту штрихкода |
Возвращаемое значение
Не возвращает значение.
|
DrawMatrixToSize Method
Рисует DataMatrix штрих код в контекст устройства. Вы можете
использовать этот метод как для отображения на экран РС, так и для
принтера.
Синтаксис
object.DrawMatrixToSize(X, Y, CX, CY, dm, [hDC])
Параметры
| X | Вещественное значение
определяющее X координату штрихкода. |
| Y | Вещественное значение
определяющее Y координату штрихкода. |
| CX | Вещественное
значение определяющее ширину шрихкода. |
| CY | Вещественное
значение определяющее высоту шрихкода. |
| dm | Необязательное (по
умолчанию dmPixels). Определяет единицы измерения cx и cy. См.
здесь. |
| hDC | Необязательное (по
умолчанию 0). Хэндл контекста устройства, который будет
использовать для рисования.
Если этот параметр не определен или равен нулю, то будет
использоваться хэндл принтера. |
Возвращаемое значение
Не возвращает значение.
Примеры
'Нарисовать DataMatrix на экран.
Call DataMatrixCtrl1.DrawMatrixToSize(0, 0, 200, 200, dmPixels, Form1.hDC)
'Напечатать DataMatrix штрихкод Открыть текущий принтер
Call DataMatrixCtrl1.BeginPrint("")
'напечатать DataMatrix в X=10 mm, Y=10 mm, ШИРИНА=25 mm, ВЫСОТА=25 mm
Call DataMatrixCtrl1.DrawMatrixToSize(10, 10, 25, 25, dmMM)
Call DataMatrixCtrl1.EndPrint
|
BeginPrint
Открывает доступ к принтеру.
Синтаксис
object.BeginPrint(sPrinterName)
Параметры
| sPrinterName | Строка определяющая имя принтера. Имя принтера можно увидеть в папке Принтеры Панели Управления.
Если имя пустое, будет открыт принтер по умолчанию. |
Возвращаемое значение
Не возвращает значение.
Примечания
Эта функция должна быть вызвана первой, до начала использования других функций печати.
|
EndPrint
Закрывает принтер. После этого нельзя применять функции печати.
Синтаксис
object.EndPrint()
Возвращаемое значение
Не возвращает значение.
|
NewPage
Начинает новую страницу.
Синтаксис
object.NewPage()
Возвращаемое значение
Не возвращает значение.
|
EndPage
Заканчивает страницу.
Синтаксис
object.EndPage()
Возвращаемое значение
Не возвращает значение.
|
GetPrinterHDC
Функция возвращает хэндл принтера ранее открытого c помошью ф-ии BeginPrint.
Синтаксис
object.GetPrinterHDC()
Возвращаемое значение
HDC
|
SetPrinterHDC Method
Устанавливает хэндл принтера, который будет применяться для печати. Если вызвана
эта ф-я, то можно не вызывать BeginPrint. В этом случае все управление
закрытием/открытием принтера и т.п. будет осуществляется вне DataMatrix-ActiveX
контрола.
Синтаксис
object.SetPrinterHDC(hDC)
Параметры
| hDC | Значение определяющее хэндл принтера. |
Возвращаемое значение
Не возвращает значение.
Пример
Printer.CurrentX = 2048
Printer.Print "SBarCode.com, VB Example"
'DataMatrix-ActiveX будет использовать объект принтера Visual Basic
Call DataMatrixCtrl1.SetPrinterHDC(Printer.hDC)
'напечатать DataMatrix штрихкоды
Call DataMatrixCtrl1.DrawMatrixToSize(10, 10, 30, 30, dmMM)
Call DataMatrixCtrl1.DrawMatrixToSize(70, 10, 30, 30, dmMM)
Printer.EndDoc
|
BinaryWritePicture
Эта функция аналогична SaveToImageFile, но в отличии от сохранения изображения в файл она представляет его как массив байт.
Синтаксис
object.BinaryWritePicture(sFmt, CX, CY)
Параметры
| sFmt | Строка определяющяя расширение имени файла. Могут использоваться следующие расширения - "wmf", "emf", "bmp", "jpg", "jpeg", "gif", "tiff" and "png". |
| CX | Целое определяющее ширину штрихкода |
| CY | Целое определяющее высоту штрихкода |
Возвращаемое значение
Variant определяющее safe array байт.
Примечания
Этот метод может быть очень удобным для пересылки изображения штрихкода через Интернет. Например, он может использоваться на IIS сервере.
Внимание! Для нормальной работы этой функции необходимо наличие библиотеки GDI+ (gdiplus.dll) на вашем PC, эта библиотека поставляется в составе Windows XP и выше. Если у вас нет такой библиотеки, то вы можете загрузить ее здесь, а затем скопировать ее в папку ../Windows/System32/.
Пример
Здесь приведен пример ASP страницы поставляемой вместе с нашим DataMatrix-ActiveX.
<%
' datamatrix.asp
' (c) 1999-2005 www.SBarCode.com
'отправить картинку в GIF формате
Response.ContentType = "image/gif"
Response.BinaryWrite Barcode.BinaryWritePicture("gif", 200, 200)
SET Barcode=nothing
%>
Примечание
Этот метод требует Server лицензии.
|
GetMatrixSize Method
Этот метод ывчисляет размер DataMatrix необходимый для получения нужного размера модуля.
Модуль - это наименьший элемент DataMatrix штрих кода.
Синтаксис
object.GetMatrixSize(module, xRes, yRes, dmIn, dmOut, width, height)
Параметры
| module | Вещественное
значение определяющее модуль PDF417. |
| xRes | Целое определяющее
разрешение (в dpi) вдоль оси X. |
| yRes | Целое определяющее
разрешение (в dpi) вдоль оси Y. |
| dmIn |
Это значение определяет единицы, в которых задан module. |
| dmOut |
Это значение определяет единицы, в которых будут выданы width, height. |
| width | Переменная,
которая получает ширину DataMatrix . |
| height | Переменная,
которая получает высоту DataMatrix . |
Примеры
Напечатать DataMatrix с модулем 40 Mils. Штрихкод будет начинаться с X=10 mm, Y=10 mm
'открыть текущий принтер
Call DataMatrixCtrl1.BeginPrint("")
'получить разрешение принтера (в dpi)
Dim dpiX As Long, dpiY As Long
dpiX = GetDeviceCaps(Printer.hdc, LOGPIXELSX)
dpiY = GetDeviceCaps(Printer.hdc, LOGPIXELSY)
'получить необходимые размеры DataMatrix штрихкода в единицах определяемых параметром dmOut
Dim Width, Height
Call DataMatrixCtrl1.GetMatrixSize(40, dpiX, dpiY, dmMils, dmMM, Width, Height)
'напечатать DataMatrix
Call DataMatrixCtrl1.DrawMatrixToSize(10, 10, Width, Height, dmMM)
'закрыть принтер
Call DataMatrixCtrl1.EndPrint
Сохранить DataMatrix в файл с модулем равным 4 пиксела.
'если dmIn и dmOut определяются в пикселах, вам не нужно задавать разрешение (xRes, yRes), но оно не может быть равно 0.
Dim Width, Height
Call DataMatrixCtrl1.GetMatrixSize(4, 1, 1, dmPixels, dmPixels, Width, Height)
Call DataMatrixCtrl1.SaveToImageFile(Width, Height, "c:\datamatrix.bmp")
|
FreezeEncode Method
Этот метод приостанавливает кодировку DataMatrix. Применение этого
метода имеет смысл в высоконагруженных приложениях, например, web
сервисах, и т.п.
Синтаксис
object.FreezeEncode(bFreeze)
Параметры
| bFreeze | Boolean которое определяет кодировать или нет DataMatrix. |
Возвращаемое значение
Не возвращает значение.
Пример
Вам нужно изменить сразу несколько свойств. Каждый раз когда
вы устанавливаете какое-либо свойство (PreferredFormat, DataToEncode, EncodingMode и др.) DataMatrix перекодируется,
т.е. вычисляются коды Reed-Solomon, заново строиться DataMatrix, и т.п.
Это забирает много процессорного времени. Для улучшения
производительности приложения, вы можете остановить это
перекодирования, а после установки всех свойств возобновить его.
DataMatrixCtrl1.FreezeEncode (True)
DataMatrixCtrl1.DataToEncode = "1234567"
DataMatrixCtrl1.EncodingMode = eC40
DataMatrixCtrl1.PreferredFormat = f64x64
DataMatrixCtrl1.FreezeEncode (False)
|