Manual PDF - LinhaBase

Transcrição

Manual do Desenvolvedor
Requisitos do Sistema ..................................................................................... 4
O Componente ............................................................................................... 5
Instalando o Componente ................................................................................. 6
Instalação ................................................................................................... 6
Local de instalação do componente .................................................................... 8
Salvando e imprimindo uma imagem de código de barras com a resolução desejada .... 9
Criando código de barras com Crystal Reports for .Net ........................................ 13
Criando Código de Barras com Crystal Reports para Visual Studio .Net com Dataset
executando um query com valor variável em modo de execução ................................22
Criando código de barras com o Report Viewer para Visual Studio .Net .................... 28
Criando Código de Barras com Report Viewer para Visual Studio .Net com Dataset
executando um query com valor variável em modo de execução ................................40
Criando código de barras na Web via ASP.NET ................................................... 45
Propriedades ............................................................................................... 47
Propriedades requeridas .............................................................................47
LinhaBase2DBarCode1.AspectFlag ...............................................................47
LinhaBase2DBarCode1.AzFlag .....................................................................47
LinhaBase2DBarCode1.AzMenu ....................................................................47
LinhaBase2DBarCode1.AzRVideo .................................................................47
LinhaBase2DBarCode1.BackColor.................................................................47
LinhaBase2DBarCode1.BorderWidth .............................................................47
LinhaBase2DBarCode1.ByteNumber .............................................................48
LinhaBase2DBarCode1.Caption ....................................................................48
LinhaBase2DBarCode1.CodeType .................................................................48
LinhaBase2DBarCode1.Columns ..................................................................49
LinhaBase2DBarCode1.Flag .........................................................................49
LinhaBase2DBarCode1.ForeColor .................................................................49
LinhaBase2DBarCode1.Orientation ...............................................................49
LinhaBase2DBarCode1.Mirror ......................................................................50
LinhaBase2DBarCode1.Reduction .................................................................50
LinhaBase2DBarCode1.SecurityLevel ............................................................50
LinhaBase2DBarCode1.StartMode ................................................................50
LinhaBase2DBarCode1.Unit .........................................................................52
LinhaBase2DBarCode1.XUnit .......................................................................52
LinhaBase2DBarCode1.Ymultiplier................................................................52
Propriedades informadoras ..........................................................................53
LinhaBase2DBarCode1.ErrorCode ................................................................53
LinhaBase2DBarCode1.Status......................................................................53
LinhaBase2DBarCode1.ImageHeight ............................................................53
LinhaBase2DBarCode1.ImageWidth .............................................................53
LinhaBase2DBarCode1.String2 ....................................................................53
LinhaBase2DBarCode1.Pattern ....................................................................54
Métodos ..................................................................................................... 55
Barcode(Graphics g) ..................................................................................55
cBarcode() ................................................................................................55
sBarcode() ................................................................................................55
As simbologias de código de barras ................................................................. 56
Aztec ........................................................................................................56
A simbologia Asteca é uma simbologia que suporta todo o conjunto de caracteres ASCII e
oferece vários modos de verificação de erros. .......................................................56
Databar .....................................................................................................57
Omnidirecional .......................................................................................57
A simbologia GS1 DataBar (anteriormente RSS) é uma família com três simbologias lineares
e três variantes empilhados. ............................................................................57
LinhaBase Software – www.linhabase.com.br
2
Truncada ...............................................................................................57
Limitada ................................................................................................58
Empilhada ..............................................................................................59
Empilhada omnidirecional ........................................................................59
Expandida ..............................................................................................60
Expandida empilhado ..............................................................................61
Datamatrix ..................................................................................................61
Datamatrix quadrado...............................................................................61
Datamatrix retangular .............................................................................62
GS1 Datamatrix ......................................................................................63
Maxicode ...................................................................................................63
PDF417 .....................................................................................................64
PDF417 Truncado ........................................................................................65
Micro PDF ..................................................................................................66
QR Code....................................................................................................66
Micro QR ...................................................................................................67
Apêndices ................................................................................................... 68
Versão de Demonstração x Versão Comercial .......................................................68
Erros ........................................................................................................68
Informações ................................................................................................68
Suporte .....................................................................................................68
3
Requisitos do Sistema
- Sistema operacional: Windows Vista, Windows 7 com Microsoft Internet Explorer 5.5 ou
superior, Windows 8, Windows 8.1 , Windows 10.
- Microsoft Visual Studio 2010 ou superior.
- Microsoft .Net Framework 3.5 ou superior.
- Computador: Pentium ou superior.
- Impressora: Para impressão do código de barras.
- Espaço em disco: 10MB disponíveis.
- Memória: 128 MB de memória RAM.
- Internet para realização da autenticação de uso.
4
O Componente
BarCode Professional 2D: Componente .Net para produção de Código de
Barras
O componente LinhaBase BarCode Professional 2D é uma biblioteca para a tecnologia
Microsoft .Net que permite criar, visualizar e imprimir códigos de barras de alta qualidade em
seus aplicativos usando VB.NET ou C#.
O LinhaBase BarCode Professional 2D, permite produzir os principais código de barras 2D,
PDF417, Datamatrix, Databar, QR Code entre outros.
Desenvolva sistemas em VB.Net, C# com código de barras para diversas finalidades:
automação comercial, logística, gestão EAN, identificação de produtos e caixas,
personalização de dados variáveis, gestão de documentos e muito mais!
Diversas simbologias em um só componente
Com LinhaBase BarCode Professional 2D, você poderá produzir código de barras nas
simbologias:
Aztec
Databar Omnidirecional
Databar Truncado
Databar Limitado
Databar Empilhado
Databar Empilhado omnidirecional
Databar Expandido
Databar Expandido Empilhado
Datamatrix
GS1 Datamatrix
Maxicode
PDF417
PDF417 Truncado
Micro PDF
QR Code
Micro QR
Licenciamento
Este produto é vendido com licenciamento ilimitado que permite o uso do produto em qualquer
quantidade de computadores e incorporar a software e distribuir a clientes como parte da
aplicação.
5
Instalando o Componente
Instalação
O Componente .Net para código de barras LinhaBase precisa ser autenticado para ter a sua
instalação concluída.
Para instalar o Componente faça o seguinte:
1 – Execute a instalação do LinhaBase Installer.
2 – Execute o LinhaBase Installer de seu produto (cada produto LinhaBase tem seu Installer
próprio, certifique que está executando o Installer correto).
3 – No LinhaBase Installer verifique o nome do produto e forneça o Número de Série e clique
no botão Autenticar.
4 – Tendo autenticado o produto clique no botão Ok para iniciar a etapa final da instalação do
produto.
6
5 – Siga as instruções para concluir o processo de instalação.
6 – Após ter terminado o processo de instalação clique no botão Sair no LinhaBase Installer.
7
Local de instalação do componente
O componente é geralmente instalado no caminho:
C:\Arquivos de Programas (x86)\LinhaBase\BarcodePro\2d\bin\
LinhaBase2DBarCodeLib.dll
Ou
C:\Arquivos de Programas\LinhaBase\BarcodePro\2d\bin\
LinhaBase2DBarCodeLib.dll
8
Salvando e imprimindo uma imagem de código de barras
com a resolução desejada
Neste projeto temos:
– Label
– Um caixa de texto
– três botões
– dois Picturebox.
- Componente de Código de Barras LinhaBase
No exemplo, será criado um código de barras e sua imagem será salva em formato
gráfico TIF com resolução de 300 dpi.
1 – Adicione a referência ao componente LinhaBase, acesse o menu Project – Add
Reference.
2 – Localize o componente e clique no botão Ok.
9
3 – Crie um form como mostrado abaixo:
4 – Acrescente o código:
Imports LinhaBase2DBarCode.LinhaBase2DBarCode
Imports System.Drawing.Imaging
Imports System.Drawing.Printing
Public Class Form1
Dim dpi As Integer = 300
Dim Xmils As Integer = 30
Dim Ymils As Integer = 3
Private WithEvents printDocument As New PrintDocument
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles MyBase.Load
Me.Text = "Salvar Código de Barras"
Label1.Text = "Valor:"
Button1.Text = "Produzir"
Button2.Text = "Salvar"
Button3.Text = "Imprimir"
PictureBox1.SizeMode = PictureBoxSizeMode.AutoSize
PictureBox2.Visible = False
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As
System.EventArgs) Handles Button1.Click
Dim LinhaBase2DBarCode As New LinhaBase2DBarCode.LinhaBase2DBarCode
Dim g As Graphics = PictureBox1.CreateGraphics()
Dim Xunit2D As Integer
Dim Ymultiplier2D As Integer
LinhaBase2DBarCode.CodeType = BarcodeSymbology.PDF417
LinhaBase2DBarCode.Unit = GraphicsUnit.Pixel
Xunit2D = Xmils
10
Ymultiplier2D = Ymils
LinhaBase2DBarCode.Xunit = Xunit2D
LinhaBase2DBarCode.Ymultiplier = Ymultiplier2D
LinhaBase2DBarCode.StartMode = 0
LinhaBase2DBarCode.Caption = TextBox1.Text
PictureBox1.Image = LinhaBase2DBarCode.Barcode(g)
g.Dispose()
End Sub
Dim
Dim
Dim
Dim
bmp As Bitmap
bmpBackground As Bitmap
objBrush As TextureBrush
objgraphics As Graphics
bmp = New Bitmap(PictureBox1.Width, PictureBox1.Height)
bmpBackground = New Bitmap(PictureBox1.Image)
objBrush = New TextureBrush(bmpBackground)
objgraphics = Graphics.FromImage(bmp)
objgraphics.Clear(LinhaBase2DBarCode.BackColor)
objgraphics.FillRectangle(objBrush, 0, 0, PictureBox1.Width,
PictureBox1.Height)
bmp.SetResolution(dpi, dpi)
bmp.Save(Application.StartupPath & "\cod.tif", ImageFormat.Tiff)
MsgBox("Código de barras foi salvo.")
End Sub
Dim PrintDialog1 = New PrintDialog
printDocument.DefaultPageSettings.PaperSize =
GetPaperSize(printDocument.PrinterSettings, PaperKind.A4)
PrintDialog1.Document = printDocument
Dim r As DialogResult = PrintDialog1.ShowDialog
If r = DialogResult.OK Then
printDocument.Print()
End If
End Sub
Private Sub printDocument_PrintPage(ByVal sender As Object, ByVal ev As
System.Drawing.Printing.PrintPageEventArgs) Handles printDocument.PrintPage
11
ev.Graphics.PageUnit = GraphicsUnit.Pixel
Dim g As Graphics = PictureBox2.CreateGraphics()
LinhaBase2DBarCode.Unit = GraphicsUnit.Millimeter
LinhaBase2DBarCode.Xunit = Xmils
LinhaBase2DBarCode.Ymultiplier = Ymils
LinhaBase2DBarCode.Caption = TextBox1.Text
'Produz cod barra
PictureBox2.Image = LinhaBase2DBarCode.Barcode(g)
g.Dispose()
PictureBox2.BackColor = Color.White
ev.Graphics.DrawImage(LinhaBase2DBarCode.Barcode(ev.Graphics), 0, 0)
End Sub
Private Function GetPaperSize(ByVal ps As PrinterSettings, ByVal Kind As
PaperKind) As PaperSize
Dim psz As PaperSize
For Each psz In ps.PaperSizes
If psz.Kind = Kind Then
Return psz
End If
Next
Return ps.PaperSizes(0)
End Function
End Class
12
Criando código de barras com Crystal Reports for .Net
1 – Abra o Visual Studio.Net e crie uma nova aplicação Windows.
Reference.
13
4 – Em Solution Explorer clique com o botão direito selecione Add – New Item.
14
5 – Adicione um Dataset ao projeto.
6 – Clique com o botão direito na área do Dataset e escolha Add – Table Adapter.
7 – Escolha a conexão com sua base de dados.
15
8 – Clique no botão New Connection e selecione o Data Source.
9 – Após ter configurado a conexão com a base de dados clique no botão Next.
10 – Salve a conexão com a base de dados e clique no botão Next.
16
11 – Selecione o tipo de Comando a ser utilizado no TableAdapter.
12 – Digite o comando SQL para execução do query.
17
13 – Escolha os métodos que serão utilizados junto ao TableAdapter.
14 – Finalize o Wizard.
15 – O DataSet está pronto e configurado no projeto.
18
16 – Clique com o botão direito no DataSet e escolha Add – Column.
17 – Adicione uma coluna tipo System.Byte() que será utilizada para apresentar o código de
barras.
18 – Adicione ao projeto um relatório Crystal Reports.
19
19 – Crie um relatório em branco.
20 – Selecione o menu Crystal Reports – Database – Database Expert.
21 – Selecione o Dataset adicionado no projeto como a fonte de dados do relatório.
20
22 – Adicione ao relatório os campos desejados e configure o tamanho dos campos.
OBS: O tamanho do campo do código de barras deve ser devidamente ajustado para não
ocorrer a impressão de um código de barras distorcido ou faltando elementos construtivos.
23 – Adicione ao Form do projeto o controle CrystalReportViewer.
24 – Adicione o código de seu projeto.
Public Class Form1
Dim ta As New dtDataSetTableAdapters.tblTestTableAdapter()
Dim dt As New dtDataSet.tblTestDataTable()
ta.Fill(dt)
Dim row As dtDataSet.tblTestRow
Dim Xunit2D As Integer = 20
Dim Ymultiplier2D As Integer = 3
21
For Each row In dt.Rows
LinhaBase2DBarCode.Caption = row.Cod
row.Barcode = LinhaBase2DBarCode.sBarcode(300, 300,
System.Drawing.Imaging.ImageFormat.Png).GetBuffer()
Next
Dim report As New report()
report.SetDataSource(CType(dt, DataTable))
CrystalReportViewer1.ReportSource = report
End Sub
End Class
Criando Código de Barras com Crystal Reports para Visual Studio .Net
com Dataset executando um query com valor variável em modo de
execução
No exemplo anterior o Dataset foi preenchido com um comando SQL do tipo Select realizando
um fill completo da base de dados. Mas também é possível preencher o Dataset com um valor
qualquer definido em modo de execução. Para isso basta criar um Query com parâmetro.
Suponhamos a existência de uma base de dados qualquer.
22
1 – Clique com o botão direito sobre o TableAdapter e escolha Add Query.
23
3 – Selecione o tipo de query a ser utilizado.
4 – Digite o comando do query e clique no botão Next.
Foi acrescentado a clausula Where onde foi definido que a pesquisa será realizada com base
no valor a ser fornecido para a coluna Name.
Select Codigo, Cod, Name From tblTest Where (Name = @PersonName)
24
5 – Selecione os métodos a serem utilizados no TableAdapter e clique no botão Finish.
6 – Clique no botão Ok para ignorar qualquer mensagem de erro junto ao query.
7 – Clique com o botão direito na linha que contêm os métodos do query e selecione
Properties.
25
8 – Selecione Parameters.
9 – Clique no botão Add.
10 – Em DBType escolha String e em ParameterName digite o nome para o parâmetro do
query e clique no botão Ok.
26
11 – O código ficará como apresentado abaixo:
Public Class Form1
Dim ta As New dtDataSetTableAdapters.tblTestTableAdapter()
Dim dt As New dtDataSet.tblTestDataTable()
ta.FillBy(dt, "linhabase")
For Each row In dt.Rows
Next
Dim report As New report()
report.SetDataSource(CType(dt, DataTable))
CrystalReportViewer1.ReportSource = report
End Sub
End Class
27
Criando código de barras com o Report Viewer para
Visual Studio .Net
1 – Abra o Visual Studio.Net e crie uma nova aplicação Windows.
Reference.
28
4 – Em Solution Explorer clique com o botão direito selecione Add – New Item.
29
5 – Adicione um Dataset ao projeto.
6 – Clique com o botão direito na área do Dataset e escolha Add – Table Adapter.
7 – Escolha a conexão com sua base de dados.
30
8 – Clique no botão New Connection e selecione o Data Source.
9 – Após ter configurado a conexão com a base de dados clique no botão Next.
10 – Salve a conexão com a base de dados e clique no botão Next.
31
12 – Digite o comando SQL para execução do query.
32
13 – Escolha os métodos que serão utilizados junto ao TableAdapter.
14 – Finalize o Wizard.
33
15 – O DataSet está pronto e configurado no projeto.
16 – Clique com o botão direito no DataSet e escolha Add – Column.
17 – Adicione uma coluna tipo System.Byte() que será utilizada para apresentar o código de
barras.
18 – Adicione ao projeto um relatório tipo Report.
34
19 – Selecione o menu Data – Add New Data Source.
20 – Selecione Object e clique no botão Next.
21 – Selecione o objeto que representa o DataTable do Dataset adicionado ao projeto e clique
no botão Finish.
35
22 – no Toolbox do Report selecione Table e insira no relatório.
23 – Na tela Dataset Properties selecione o Data Source que foi criado no projeto e clique no
botão Ok.
25 – Adicione a tabela os campos que deseja incluir no relatório.
36
26 – Configure o campo Image para conter corretamente o código de barras.
27 – Ajuste o tamanho do campo de modo a conter corretamente a imagem do código de
barras.
OBS: O tamanho do campo do código de barras deve ser devidamente ajustado para não
ocorrer a impressão de um código de barras distorcido ou faltando elementos construtivos.
37
28 – Adicione ao Form o controle ReportViewer, selecione o report do projeto e ajuste a
propriedade Dock para Fill.
29 – Ajuste o código do Form.
Public Class Form1
'TODO: This line of code loads data into the 'dtDataSet.tblTest' table.
You can move, or remove it, as needed.
Me.tblTestTableAdapter.Fill(Me.dtDataSet.tblTest)
For Each row In dtDataSet.tblTest.Rows
Next
Me.ReportViewer1.RefreshReport()
End Sub
End Class
38
39
Criando Código de Barras com Report Viewer para Visual Studio .Net com
Dataset executando um query com valor variável em modo de execução
No exemplo anterior o Dataset foi preenchido com um comando SQL do tipo Select realizando
um fill completo da base de dados. Mas também é possível preencher o Dataset com um valor
qualquer definido em modo de execução. Para isso basta criar um Query com parâmetro.
1 – Clique com o botão direito sobre o TableAdapter e escolha Add Query.
40
3 – Selecione o tipo de query a ser utilizado.
4 – Digite o comando do query e clique no botão Next.
Foi acrescentado a clausula Where onde foi definido que a pesquisa será realizada com base
no valor a ser fornecido para a coluna Person.
Select Codigo, Cod, Name From tblTest Where (Name = @PersonName)
41
5 – Selecione os métodos a serem utilizados no TableAdapter e clique no botão Finish.
6 – Clique no botão Ok para ignorar qualquer mensagem de erro junto ao query.
7 – Clique com o botão direito na linha que contêm os métodos do query e selecione
Properties.
42
8 – Selecione Parameters.
9 – Clique no botão Add.
10 – Em DBType escolha String e em ParameterName digite o nome para o parâmetro do
query e clique no botão Ok.
43
11 – O código ficará como apresentado abaixo:
Public Class Form1
'TODO: This line of code loads data into the 'dtDataSet.tblTest' table.
You can move, or remove it, as needed.
tblTestTableAdapter.FillBy(dtDataSet.tblTest, "linhabase")
For Each row In dtDataSet.tblTest.Rows
Next
Me.ReportViewer1.RefreshReport()
End Sub
End Class
44
Criando código de barras na Web via ASP.NET
1 - Para criar código de barras na Web, abra o Visual Studio .Net e crie uma nova aplicação
ASP.NET Web Application.
2 – Crie um WebForm e nomeie como barcode.aspx.
3 – Adicione a referência ao arquivo LinhaBase2DBarcodeLib.dll.
4 – Crie um form HTML e nomeie como barcodetest.htm. A aplicação deverá ficar como a
indicada na figura abaixo.
5 – O código da página barcode.aspx deverá ficar como indicado abaixo:
Imports System.Drawing
Partial Class barcode
Inherits System.Web.UI.Page
Protected Sub Page_Load(sender As Object, e As System.EventArgs) Handles
Me.Load
Dim heightmm As Single = 5
Dim widthmm As Single = 20
Dim bcp As New LinhaBase2DBarCode.LinhaBase2DBarCode
bcp.Caption = Request.QueryString("code")
bcp.CodeType = BarcodeSymbology.QR_Code
bcp.Xunit = 15
bcp.Ymultiplier = 3
bcp.StartMode = 2
bcp.Unit = Drawing.GraphicsUnit.Millimeter
Dim
barcodeImage
As
Byte()
=
bcp.sBarcode(300,
300,
45
If (barcodeImage Is Nothing) Then
Response.End()
Else
Response.Clear()
Response.ContentType = "image/png"
Response.BinaryWrite(barcodeImage)
Response.End()
End If
End Sub
End Class
6 – O código da página barcodetest.htm deverá ficar como indicado abaixo:
<!DOCTYPE
html
PUBLIC
"-//W3C//DTD
XHTML
1.0
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
Transitional//EN"
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title></title>
<script type="text/javascript">
function ChangeBarcode(code)
{
var elem = document.getElementById("imgBarcode");
if(elem!=null)
elem.src="barcode.aspx?code="+code;
}
</script>
</head>
<body>
<P>
<FONT face="Arial"><b>LinhaBase Barcode Professional 2D</b></FONT></P>
<P>
<IMG id="imgBarcode" alt="" src="barcode.aspx?code=789123456789"></P>
<P>
<FONT face="Arial" size="2">Enter a value to encode:</FONT><BR>
<INPUT id="Text1" type="text" name="Text1">
<INPUT id="Button1" type="button" value="View Barcode" name="Button1"
onclick="ChangeBarcode(Text1.value)">
</P>
</body>
</html>
O exemplo poderá ser ampliado conforme a necessidade do usuário.
46
Propriedades
Propriedades requeridas
LinhaBase2DBarCode1.AspectFlag
Determina a interpretação da propriedade Columns para o código de barras PDF417. Um valor
1 interpreta o número de colunas e o número de fileiras necessários a simbologia.
- Tipo: Integer
- Default: 0
- Valores permitidos: 0 e 1
LinhaBase2DBarCode1.AzFlag
Define o flag para a simbologia Aztec.
- Tipo: BOOL
- Default: FALSE
LinhaBase2DBarCode1.AzMenu
Define o flag de Menu para a simbologia Aztec.
- Tipo: BOOL
- Default: FALSE
LinhaBase2DBarCode1.AzRVideo
Especifica o flag de vídeo reverso para a simbologia Aztec.
- Tipo: BOOL
- Default: FALSE
LinhaBase2DBarCode1.BackColor
Especifica a cor de trás das barras.
- Tipo: Color
- Default: Color.White
- Valores permitidos: Qualquer valor para cor.
LinhaBase2DBarCode1.BorderWidth
Especifica a espessura (na unidade determinada pela propriedade PageUnit) da borda envolta
da imagem.
- Tipo: float
- Default: 0.0 (sem borda)
- Valores permitidos: Qualquer um
47
LinhaBase2DBarCode1.ByteNumber
Para as simbologias: Aztec, Datamatrix, PDF417 e QR Code.
Esta propriedade deve ser normalmente fixado em 0 quando a propriedade Caption deriva de
uma sequencia de caracteres.
Quando ByteValue é maior do que 0 o valor de Caption (que é uma cadeia Unicode) é
desempacotado em bytes (8 bits) antes dos dados serem utilizados para gerar o código de
barras.
Se ByteNumber for definido com um valor diferente de zero, esta propriedade deve ser definida
depois que a propriedade Caption.
Consulte Usando dados em bytes para mais informações.
- Tipo: Integer
- Default: 0
- Valore permitidos: 0 até a capacidade máxima da simbologia.
LinhaBase2DBarCode1.Caption
Especifica o valor do código de barras.
- Tipo: string
- Default: "LinhaBase"
- Valores permitidos: Qualquer texto dependendo da simbologia de código de barras
selecionada.
Obs: Deverá ser utilizando como valor texto compatível com a simbologia de código de barras
selecionada. Valores incompatíveis apresentarão erro como resposta.
LinhaBase2DBarCode1.CodeType
Especifica a simbologia de código de barras a ser produzida.
- Tipo: Valor membro de enumeração.
- Default: Aztec
- Valores permitidos: Valores mostrados na tabela abaixo.
Simbologia
Aztec
Datamatrix
Maxicode
PDF417
Micro PDF
Databar
QR Code
PDF417 Truncado
Micro QR
CodeType
Aztec
Datamatrix
Maxicode
PDF417
Micro_PDF
Databar
QR_Code
Trucated_PDF417
Micro_QR_Code
Valor CodeType
0
1
2
3
4
5
6
7
8
48
LinhaBase2DBarCode1.Columns
Para as simbologias: PDF417, Micro PDF, QR Code, Micro QR Datamatrix, Databar (expandido
empilhados).
Para as simbologias PDF417, Micro PDF, Databar "Colunas" se refere ao número de
Datawords em uma fileira - não o número de barra. Dependendo da simbologia nem todos os
valores são possíveis. Por exemplo, a simbologia PDF417 requer o mínimo de três linhas,
independentemente do número de colunas.
Para as simbologias Datamatrix e QR Code "Colunas" se refere ao número de elementos
quadrados em uma fileira. Apenas tamanhos de símbolos específicos são permitidos nessas
simbologias. Se um número inválido de colunas é especificado o próximo número válido será
usado. A propriedade deve ser ajustada para zero se desejar que o tamanho do símbolo seja
determinado pela definição do nível de segurança.
- Tipo: Integer
- Default: 0
- Valores permitidos: 0 – até o tamanho máximo da simbologia.
LinhaBase2DBarCode1.Flag
Para as simbologias: Aztec, Datamatrix, PDF417 e QR Code.
Quando a propriedade for definido como TRUE os o valor de Caption será convertido de
Unicode para um fluxo de bytes permitindo quaisquer caracteres Unicode sejam codificado
como uma sequência de bytes. Se a propriedade for FALSE (padrão), então a interpretação
dos dados depende do valor da propriedade ByteNumber; se for 0 então Unicode é convertido
em bytes individuais para o caractere ASCII e bytes duplos para outros caracteres. Se
ByteNumber é maior que 0, os dados são convertidos em caracteres ASCII de 8 bit antes dos
dados serem utilizados para gerar o código de barras.
Se o flag for TRUE qualquer valor de ByteNumber é ignorado; além disso, o flag deve ser
utilizado apenas nos códigos de barras byte/modo binário (incluindo modo de Kanji para
símbolos QR).
- Tipo: BOOL
- Default: FALSE
LinhaBase2DBarCode1.ForeColor
Especifica a cor das barras e da legenda do código de barras.
- Tipo: Color
- Default: Color.Black
- Valores permitidos: Qualquer cor válida.
LinhaBase2DBarCode1.Orientation
Especifica o angulo de orientação da imagem do código de barras.
- Tipo: integer
- Default: 0.
- Valores permitidos: 0 a 360°.
49
LinhaBase2DBarCode1.Mirror
Especifica se a imagem do código de barras será espelhado.
- Tipo: BOOL
- Default: False
Obs: Imagens de código de barras espelhados não são corretamente escaneados por
equipamentos de leitura.
LinhaBase2DBarCode1.Reduction
Especifica o percentual de redução da espessura das barras (útil para alguns processos de
impressão).
- Tipo: float
- Default: 0
- Valores permitidos: 0 - 50 (%)
LinhaBase2DBarCode1.SecurityLevel
Este parâmetro especifica o nível de segurança.
Os valores permitidos são 0 a 8 para PDF417.
Os valores permitidos para os códigos astecas dependem do modo, para o modo Normal é de
0 a 99, para o modo Compact o valor é de 1 a 4, e para o modo Full é de 1 a 32.
Para a simbologia Datamatrix os valores permitidos são 0 a 23 para Datamatrix quadrados, ou
de 0 a 6 para Datamatrix retangulares.
Para a simbologia QR Codes os níveis de segurança permitidos são de 0 a 3. Para a
simbologia Micro QR Code os valores são de 0 a 2.
Para outros tipos de código de barras desse parâmetro deve ser 0.
- Tipo: Integer
- Default: 0
LinhaBase2DBarCode1.StartMode
Alguns tipos de código de barras 2D suportam diferentes modos de codificação de dados. Este
parâmetro permite que o modo inicial seja especificado.
Para outros tipos de código de barras o modo é determinado automaticamente e o parâmetro
StartMode deve ser 0.
- Tipo: Integer
- Default: 0
50
PDF417
StartMode
0
1
2
3
4
5
Modo
EXC Alpha
EXC Lower
EXC Mixed
EXC Punctuation
Binary/ASCII Plus
Numeric mode
Para a maioria das aplicações o valor StartMode deve ser 0, a o componente irá adotar o modo
apropriado.
Aztec
StartMode
0
1
2
3
Modo
Normal
Compact
Full range
Rune
Para a maioria das aplicações o valor StartMode deve ser 0, juntamente com um nível de
segurança de 0 fornece o valor padrão de 23% + 3 codewords.
Datamatrix
StartMode
0
1
Modo
Auto Square
Auto Rectangular
Maxicode
StartMode
0
1
2
3
4
5
6
Modo
Mode 2 (Structured Carrier Message –
Numeric Postal Code)
Mode 3 (Structured Carrier Message –
Alphanumeric Postal Code)
Mode 4 – Standard Symbol (SEC)
Mode 5 – Full EEC Symbol
Mode 6 – Reader Program (SEC)
51
Databar
StartMode
0
1
2
3
4
5
6
Modo
Omnidirection
Truncated
Limited
Stacked
Stacked Omnidirectional
Expanded
Expanded Stacked
QR Code e Micro QR
StartMode
0
1
2
3
Modo
Numérico
Alfanumérico*
Byte
Kanji
*O padrão alfanumérico QR Code, codifica apenas letras maiúsculas. Para codificar
letras maiúsculas e minúsculas, utilize o modo Byte.
LinhaBase2DBarCode1.Unit
Especifica a unidade de medida, utilizado na propriedade:
- BarcodeWidth
- Tipo: GraphicsUnit
- Default: Millimeter
- Valores permitidos: Document, Display, Pixel, Point, Millimeter e Inch.
LinhaBase2DBarCode1.XUnit
A propriedade XUnit pode ser usada para especificar a largura (em mils) do menor elemento do
código de barras.
A utilização de valores menores do que 8 irá produzir uma imagem de código de barras, mas
que não atende às especificações técnicas e pode não ser decodificado.
Para a simbologia Maxicode esta propriedade é usada para especificar a dimensão L (a altura
da imagem em mm) e o padrão é 25,50 milímetros.
- Tipo: Single
- Default: 15.0
- Valores permitidos: 8.0 até 225.0.
LinhaBase2DBarCode1.Ymultiplier
A propriedade Ymultiplier pode ser usada para especificar a altura (em Xunits) dos elementos
do código de barras.
52
Usando valores fora da faixa permitida irá gerar um código de barras que pode não se
decodificado. Alguns tipos de código de barras Databar têm valores padrão para essa
propriedade e irá ignorar a configuração desta propriedade.
Esta propriedade está disponível apenas para simbologias PDF417 e Databar.
- Tipo: Single
- Default: 3.0
- Valores permitidos: 2.0 a 5.0 para PDF417, 1.0 a 255.0 para Databar.
Propriedades informadoras
As propriedades informadoras somente podem ser utilizadas após o método Barcode() ser
chamado.
LinhaBase2DBarCode1.ErrorCode
Retorna valor representando o código de erro. Se o código for 0, representa que o código de
barras foi devidamente criado. Propriedade de somente leitura.
- Tipo: Integer
LinhaBase2DBarCode1.Status
Retorna string do valor interpretado do código de erro. Propriedade de somente leitura.
- Tipo: String
Error
0
1
2
3
4
Status
OK
Illegal character in data (character illegal no dado)
Wrong data length (comprimento de dados errado)
Error in barcode data (erro nos dados do código de barras)
Graphics drawing error (erro ao desenhar a imagem do código de barras)
LinhaBase2DBarCode1.ImageHeight
Retorna a altura da imagem do código de barras, o valor inclui, bordas, margem e a legenda.
Propriedade de somente leitura.
- Tipo: Float
LinhaBase2DBarCode1.ImageWidth
Retorna a largura da imagem do código de barras, o valor inclui, bordas, margem e a legenda.
- Tipo: Float
LinhaBase2DBarCode1.String2
Retorna o texto da propriedade Caption mais o dígito verificador da simbologia, quando houver.
- Tipo: String
53
LinhaBase2DBarCode1.Pattern
Retorna a sequencia binária do valor codificado.
- Tipo: String
54
Métodos
Barcode(Graphics g)
- Tipo retornado: Metafile
Este método faz com que a imagem do código de barras seja produzida pela propriedade
Graphics de g.
cBarcode()
- Tipo retornado: Integer
Copia a imagem do código de barras para o clipboard.
sBarcode()
sBarcode(int hDpi, int vDpi) gera uma imagem dimensionada com resoluções horizontais e
verticais de HDPI e vDpi por pontos por polegada.
Return Type: Metafile
sBarcode(Graphics g, int hDpi, int vDpi) gera uma imagem dimensionada com resoluções
horizontais e verticais de HDPI e vDpi por pontos por polegada, usando as propriedades de
Graphics g. Se hDpi e vDpi for zero serão usadas as propriedades do Graphics g.
Return Type: Metafile
sBarcode(int hDpi, int vDpi, ImageFormat im) gera uma imagem fluxo de memória com
resoluções horizontais e verticais de HDPI e vDpi por pontos por polegada.
55
As simbologias de código de barras
Aztec
A simbologia Asteca é uma simbologia que suporta todo o conjunto de caracteres ASCII e
oferece vários modos de verificação de erros.
A dimensão do símbolo é caracterizada pelo número de "camadas" fora do ponto central, e isto
pode variar 1 a 32.
Escolha da simbologia:
LinhaBase2DBarCode.CodeType =
LinhaBase2DBarCode
BarcodeSymbology.
BarcodeSymbology.Aztec
OBS:: A escolha da simbologia deve ser indicado antes da indicação do valor a ser codificado
(LinhaBase2DBarCode.Caption).
.Caption).
Valor a ser codificado (exemplo):
LinhaBase2DBarCode
LinhaBase2DBarCode.Caption
= "0123456789"
Nível de segurança:
LinhaBase2DBarCode
LinhaBase2DBarCode.SecurityLevel
= 0
Número de colunas:
LinhaBase2DBarCode.
LinhaBase2DBarCode.Columns
= 0
Start Mode:
56
Databar
Omnidirecional
A simbologia GS1 DataBar (anteriormente RSS) é uma família com três simbologias lineares e
três variantes empilhados.
A variante
iante omnidirecional codifica os 14 dígitos de identificação GS1 do item comercial.
BarcodeSymbology.
BarcodeSymbology.Databar
LinhaBase2DBarCode.Cap
= "01234567890123"
"
LinhaBase2DBarCode.SecurityLevel = 0
Número de colunas:
LinhaBase2DBarCode.Columns = 0
Start Mode:
Truncada
BarcodeSymbology.
57
= "01234567890123"
"
Número de colunas:
Start Mode:
Limitada
A versão limitada codifica a identificação de itens comerciais adequados para uso em
embalagens de pequena dimensão,
dimensão mas não para uso em pontos de venda.
BarcodeSymbology.
= "01234567890123"
"
Número de colunas:
LinhaBase2DBarCode
= 0
Start Mode:
58
Empilhada
BarcodeSymbology.
= "01234567890123"
"
Número de colunas:
LinhaBase2DBarCode
= 0
Start Mode:
Empilhada omnidirecional
BarcodeSymbology.
= "01234567890123"
"
Número de colunas:
LinhaBase2DBarCode
= 0
59
Start Mode:
Expandida
A versão expandida codifica os 14 dígitos de identificação de itens comerciais mais elementos
complementares de AI (Application Identifiers).
Identifiers)
BarcodeSymbology.
= "01234567890123"
"
Número de colunas:
Start Mode:
60
Expandida empilhado
BarcodeSymbology.
= "01234567890123"
"
LinhaBase2DBarCode.SecurityLevel
aBase2DBarCode.SecurityLevel = 0
Número de colunas:
Start Mode:
Datamatrix
A simbologia DataMatrix é uma simbologia bidimensional, que é constituído por módulos
quadrados dispostos dentro de um localizador.
localizador A simbologia Datamatrix
atrix pode ser quadrada ou
retangular.
Datamatrix quadrado
BarcodeSymbology.
gy.Datamatrix
61
= "0123456789"
Número de colunas:
Start Mode:
Datamatrix retangular
BarcodeSymbology.
BarcodeSymbology.Datamatrix
= "0123456789"
Número de colunas:
Start Mode:
62
GS1 Datamatrix
O código de barras GS1 Datamatrix apresenta como caractere de Start o código de função
FNC1, este código tem o valor ASCII 232.
BarcodeSymbology.
BarcodeSymbology.Datamatrix
LinhaBase2DBarCode.Caption = Chr(232) &
LinhaBase2DBarCode.Ca
" 0101234567890123"
0101234567890123
Número de colunas:
Start Mode:
Maxicode
A simbologia Maxicode é destinada
d
principalmente para a codificação de endereços para
aplicações de correio e de entrega.
entrega
BarcodeSymbology.
BarcodeSymbology.Maxicode
cod
=
63
"[)>" + RS + "01" + GS + "96336091062" + GS + "840" +
GS + "002" + GS + "1Z14647438" + GS + "UPSN" + GS +
"410E1W" + GS + "195" + GS + GS + "1/1" + GS + GS + "Y"
+ GS + "135Lightner" + GS + "TAMPA" + GS + "FL" + RS +
EOT"
Onde,
GS = Chr(29)
RS = Chr(30)
EOT = Chr(4)
Número de colunas:
Start Mode:
PDF417
A simbologia PDF417 é uma simbologia de código de barras empilhados
empilhad s capaz de codificar
uma grande quantidade de dados.
dados
BarcodeSymbology.
BarcodeSymbology.PDF417
= "0123456789"
64
Número de colunas:
Start Mode:
PDF417 Truncado
BarcodeSymbology.
BarcodeSymbology.Truncated_PDF417
= "0123456789"
Número de colunas:
Start Mode:
65
Micro PDF
BarcodeSymbology.
BarcodeSymbology.Micro_PDF
= "0123456789"
Número de colunas:
LinhaBase2DBarCode.Col
= 0
Start Mode:
QR Code
BarcodeSymbology.
BarcodeSymbology.QR_Code
= "0123456789"
Número de colunas:
= 0
66
Start Mode:
Micro QR
BarcodeSymbology.
BarcodeSymbology.Micro_QR_Code
= "0123456789"
Número de colunas:
= 0
Start Mode:
67
Apêndices
Versão de Demonstração x Versão Comercial
O componente versão de demonstração apresenta as mesmas funcionalidades da versão
comercial, contudo o valor codificado sofrerá ligeiras modificações em relação ao dado original
informado pelo usuário.
Erros
O código de barras não pode ser lido pelo equipamento decodificador
Resposta:
1 – Verifique se o tamanho do código de barras não é muito pequeno ou grande de mais para o
equipamento leitor. Os leitores de código de barras trabalham dentro de características de
sensibilidade dado por cada fabricante.
2 – Verifique se as cores escolhidas para o fundo e as barras não são próximas. É necessário
que sejam escolhidas cores onde existam diferenças significativas entre as barras e o fundo,
como barras pretas e fundo branco.
4 – Verifique se o tipo de código de barras escolhido pode ser lido pela leitora. Nem todos os
códigos de barras são compatíveis com o modelo de leitora utilizado.
5 – Verifique se a impressora utilizada está imprimindo um código de barras de boa qualidade.
6 – Verifique se a quantidade de caracteres contidos no código de barras ultrapassa a
quantidade máxima de caracteres permitidos pelo modelo da leitora. A maioria das leitoras de
código de barras trabalha com um buffer interno que limita a quantidade máxima de caracteres
por código de barras.
7 – Verifique se o Word ou outro editor de texto realizou alguma alteração nos caracteres ou
correção ortográfica automática.
Informações
Figuras Ilustrativas
As figuras ilustrativas foram tiradas de uma determinada versão do Pacote de Fontes de
Código de Barras, podendo ser ligeiramente diferentes em outras versões do pacote.
Suporte
O suporte a este produto se restringe apenas as fontes fornecidas no pacote. A criação,
modificação, implantação e/ou programação do código fonte ou de outros que possam se
originar dos exemplos contidos neste manual para qualquer linguagem de programação e ou
sistema é de total responsabilidade do usuário.
O conteúdo deste pacote é protegido pelas leis federais 9.609 de 19 de fevereiro de 1998 e
9.610 de 19 de fevereiro de 1998 e por tratados internacionais. A reprodução ou a distribuição
não autorizada deste pacote de programas e ou arquivos, ou de qualquer porção deste, pode
gerar penalidades civis e criminais.
68

Manual PDF - LinhaBase

Transcrição

Documentos relacionados

A bandeira do Canadá, a Maple Leaf Flag, é constituída por um

“Smartphones” os Telefones Inteligentes que Escaneiam os

Leitores de Código de Barras

Baixar Ficha Técnica em PDF

Faça o da Ficha Técnica Completa

AQUISIÇÃO DE LEITORES DE CÓDIGO DE BARRAS

Matemática - Escola Virtual

Barras de muesli crocante Ingredientes

PEF 604 l EI =

Leitores de Código de Barras e CMC-7