BarCode ActiveX Control


Функции ABarCode-ActiveX



AboutBox
Открывает окно "О программе".

Синтаксис
object.AboutBox()
Возвращаемое значение
Не возвращает значение.



ShowProperties
Откывает окно свойств штрихкода.

Синтаксис
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/.
Examples
'1.
'Сохранить изображение в файл формата JPEG. Размер изображения будет 200x100 пикселов с разрешением 96 dpi.

Call ActiveBC1.SaveToImageFile(200, 100, "c:\barcode.jpg")

'2.
'Сохранить изображение в файл формата JPEG. Размер изображения будет 50x25 миллиметров с разрешением 300 dpi.

Call ActiveBC1.SaveToImageFile(50, 25, "c:\barcode.jpg", 300, dmMM)

'3.
Вычислить необходимую ширину штрихкода. См. GetBarcodeWidth.

Dim barWidth As Double
barWidth = ActiveBC1.GetBarcodeWidth(0.5, 300, 300, dmMM)
'Сохранить изображение в файл формата JPEG. Штрихкод будет иметь x-dimension 0.5 мм и высоту 25 мм.
Call ActiveBC1.SaveToImageFile(barWidth, 25, "c:\barcode.jpg", 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 ActiveBC1.PartialWritePicture("c:\1.jpg", 10, 10, 115, 50)

Barcode ActiveX сохраняет изображение штрихкода в существующий файл картинки

Используя этот метод, можно добавить к любому вашему image файлу штрихкод, который может использоваться для идентификации файла или для иных целей.



DrawBarcodeToSize
Напечатать штрихкод в контекст устройства. В качестве устройства можно использовать принтер или экран.

Синтаксис
object.DrawBarcodeToSize(X, Y, CX, CY, dm, [hDC])

Параметры

XВещественное значение определяющее X координату штрихкода.
YВещественное значение определяющее Y координату штрихкода.
CXВещественное значение определяющее ширину штрихкода.
CYВещественное значение определяющее высоту штрихкода.
dmНеобязательное (по умолчанию dmPixels). Определяет единицы измерения, которые используются для задания cx и cy. См. здесь.
hDCНеобязательное (по умолчанию 0). Хэндл устройства, в которое будет происходить печать. Если этот параметр не установлен или равен нулю, то будет использоваться принтер.

Возвращаемое значение

Не возвращает значение.
Примеры
'Нарисовать штрихкод на экран.
Dim minWidth As Long
minWidth = oABarCode.MinBarcodeWidth
Call oABarCode.DrawBarcodeToSize(5, 5, minWidth, 45, dmPixels, Form1.hdc)


'Print a barcode
'Отрыть текущий принтер

Call oABarCode.BeginPrint("")

'print a barcode to X=10 mm, Y=10 mm, WIDTH=100 mm, HEIGHT=25 mm
Call oABarCode.DrawBarcodeToSize(10, 10, 100, 25, dmMM)

Call oABarCode.EndPrint
См. также
Программирование штрихкодов



CopyToClipboard
Копирует изображение штрихкода в буфер обмена. После этого вы можете использовать Ctrl+V для вставки штрихкода.

Синтаксис
object.CopyToClipboard(cx, cy)
Параметры
cxЦелое значение определяющее ширину штрихкода
cyЦелое значение определяющее высоту штрихкода
Возвращаемое значение
Не возвращает значение.



BeginPrint
Открывает доступ к принтеру.

Синтаксис
object.BeginPrint(sPrinterName)
Параметры
sPrinterNameСтрока определяющая имя принтера. Имя принтера можно увидеть в папке Принтеры Панели Управления.
Если имя пустое, будет открыт принтер по умолчанию.
Возвращаемое значение
Не возвращает значение.
Примечания
Эта функция должна быть вызвана первой, до начала использования других функций печати.
Примеры
'Открыть текущий принтер
Call oABarCode.BeginPrint("")

'напечатать штрихкод в X=10 mm, Y=10 mm, ШИРИНА=100 mm, ВЫСОТА=25 mm
Call oABarCode.DrawBarcodeToSize(10, 10, 100, 25, dmMM)

'Начать новую страницу
Call oABarCode.NewPage

'напечатать штрихкод в X=10 mm, Y=10 mm, ШИРИНА=100 mm, ВЫСОТА=25 mm
Call oABarCode.DrawBarcodeToSize(10, 10, 100, 25, dmMM)

Call oABarCode.EndPrint



EndPrint
Закрывает принтер. После этого нельзя применять функции печати.

Синтаксис
object.EndPrint()
Возвращаемое значение
Не возвращает значение.



NewPage
Начинает новую страницу.

Синтаксис
object.NewPage()
Возвращаемое значение
Не возвращает значение.



EndPage
Заканчивает страницу.

Синтаксис
object.EndPage()
Возвращаемое значение
Не возвращает значение.



GetPrinterHDC
Функция возвращает хэндл принтера ранее открытого c помошью ф-ии BeginPrint.

Синтаксис
object.GetPrinterHDC()

Возвращаемое значение
HDC



SetPrinterHDC
Устанавливает хэндл принтера, который будет применяться для печати. Если вызвана эта ф-я, то можно не вызывать BeginPrint. В этом случае все управление закрытием/открытием принтера и т.п. будет осуществляется вне ABarCode-ActiveX контрола.

Синтаксис
object.SetPrinterHDC(hDC)
Параметры
hDCЗначение определяющее хэндл принтера.
Возвращаемое значение
Не возвращает значение.
Пример
Printer.CurrentX = 2048
Printer.Print "SBarCode.com, VB Example"

'ABarCode-ActiveX будет использовать Visual Basic принтер
Call ActiveBC1.SetPrinterHDC(Printer.hdc)

'напечатать штрихкод
Call ActiveBC1.DrawBarcodeToSize(10, 10, 100, 25, dmMM)

Printer.EndDoc



BinaryWritePicture
Эта функция аналогична SaveToImageFile, но в отличии от сохранения изображения в файл она представляет его как массив байт.

Синтаксис
object.BinaryWritePicture(sFmt, CX, CY)

Параметры

sFmtString that specifies the file name extension.
The following extensions can be used - "wmf", "emf", "bmp", "jpg", "jpeg", "gif", "tiff" and "png".
CXAn integer that defines the barcode width
CYAn integer that defines the barcode height

Возвращаемое значение

Variant определяющее safe array байт.
Примечания
Этот метод может быть очень удобным для пересылки изображения штрихкода через Интернет. Например, он может использоваться на IIS сервере.

Внимание! Для нормальной работы этой функции необходимо наличие библиотеки GDI+ (gdiplus.dll) на вашем PC, эта библиотека поставляется в составе Windows XP и выше. Если у вас нет такой библиотеки, то вы можете загрузить ее здесь, а затем скопировать ее в папку ../Windows/System32/.

Пример
Здесь приведен пример ASP страницы поставляемой вместе с ABarCode-ActiveX.
<%
' abarcode.asp
' (c) 1999-2005 www.SBarCode.com

dim oBarcode
Set oBarcode = Server.CreateObject("ABarCode.ActiveBC.1")
oBarcode.BarText = "01234567"
oBarcode.BarType = 0

' we are sending a GIF image to the client
Response.ContentType = "image/gif"
Response.BinaryWrite oBarcode.BinaryWritePicture("gif", 200, 100)

SET Barcode=nothing
%>
			
Note
Этот метод требует Server лицензии.



GetBarcodeWidth
Этот метод возвращает ширину, которую должен иметь штрихкод для того, чтобы получить требуемый x-dimension.

Синтаксис
object.GetBarcodeWidth(lModule, xRes, yRes, dm)

Параметры

lModuleThis double value that defines the necessary x-dimension.
xResA long value that defines the resolution in dpi) along x axis.
yResA long value that defines the resolution in dpi) along y axis.
dmНе обязательный (по умолчанию dmPixels). Этот параметр задает единицы измерения, которые используются для определения lModule. Результат, также возвращается в этих же единицах измерения. См. здесь.

Возвращаемое значение

Метод возвращает требуемую ширину штрихкода в той единице измерения, которая задана парметром dm.
require a barcode width
Пример
'получить разрешение принтера (dpi - dots per inch)
Dim dpiX As Long, dpiY As Long
dpiX = GetDeviceCaps(Printer.hdc, LOGPIXELSX)
dpiY = GetDeviceCaps(Printer.hdc, LOGPIXELSY)

Dim barWidth As Double
barWidth = oABarCode.GetBarcodeWidth(0.508, dpiX, dpiY, dmMM)
См. также
Программирование штрихкодов





  www.SBarCode.com