You are on page 1of 106

ComponentOne

BarCode for WinForms

Copyright 1987-2015 GrapeCity, Inc. All rights reserved.

ComponentOne, a division of GrapeCity


201 South Highland Avenue, Third Floor
Pittsburgh, PA 15206 USA

Website:
Sales:
Telephone:

http://www.componentone.com
sales@componentone.com
1.800.858.2739 or 1.412.681.4343 (Pittsburgh, PA USA Office)

Trademarks
The ComponentOne product name is a trademark and ComponentOne is a registered trademark of GrapeCity, Inc.
All other trademarks used herein are the properties of their respective owners.

Warranty
ComponentOne warrants that the media on which the software is delivered is free from defects in material and
workmanship, assuming normal use, for a period of 90 days from the date of purchase. If a defect occurs during this
time, you may return the defective media to ComponentOne, along with a dated proof of purchase, and
ComponentOne will replace it at no charge. After 90 days, you can obtain a replacement for the defective media by
sending it and a check for $25 (to cover postage and handling) to ComponentOne.
Except for the express warranty of the original media on which the software is delivered is set forth here,
ComponentOne makes no other warranties, express or implied. Every attempt has been made to ensure that the
information contained in this manual is correct as of the time it was written. ComponentOne is not responsible for
any errors or omissions. ComponentOnes liability is limited to the amount you paid for the product. ComponentOne
is not liable for any special, consequential, or other damages for any reason.

Copying and Distribution


While you are welcome to make backup copies of the software for your own use and protection, you are not
permitted to make copies for the use of anyone else. We put a lot of time and effort into creating this product, and
we appreciate your support in seeing that it is used by licensed users only.

Table of Contents
BarCode for WinForms Overview ................................................................................................. 4
Key Features.................................................................................................................................. 4
BarCode for WinForms Quick Start............................................................................................... 5
Step 1: Setting Up the Project................................................................................................... 5
Step 2: Adding Code to the Project........................................................................................... 6
Step 3: Running the Project ...................................................................................................... 8
Using BarCode for WinForms...................................................................................................... 10
BarCode Symbology ................................................................................................................ 10
BarCode Options ..................................................................................................................... 20
Customizing the C1BarCode Control .......................................................................................... 24
API Reference.............................................................................................................................. 26
C1.Win.C1BarCode.4 Assembly .............................................................................................. 27
Namespaces ........................................................................................................................ 27
C1.Win.C1BarCode Namespace ...................................................................................... 27
Overview ..................................................................................................................... 27
Classes ......................................................................................................................... 28
C1BarCode............................................................................................................... 28
Overview ............................................................................................................. 29
Members ............................................................................................................. 30
C1BarCode Constructor ...................................................................................... 41
Methods .............................................................................................................. 42
GetImage Method ........................................................................................... 44
GetImage(ImageFormat) Method............................................................... 45
GetImage(ImageFormat,Int32,Int32) Method ............................................ 46
Properties............................................................................................................ 47
BackColor Property ......................................................................................... 52
BarDirection Property ..................................................................................... 53
BarHeight Property ......................................................................................... 53
BarNarrow Property ........................................................................................ 54
BarWide Property ........................................................................................... 54
CodeType Property ......................................................................................... 55
EncodingException Property ........................................................................... 56

Font Property .................................................................................................. 56


ForeColor Property ......................................................................................... 57
Image Property ............................................................................................... 58
ShowText Property.......................................................................................... 58
SizeMode Property ......................................................................................... 59
Text Property .................................................................................................. 60
C1QRCode ............................................................................................................... 60
Overview ............................................................................................................. 62
Members ............................................................................................................. 63
C1QRCode Constructor ....................................................................................... 74
Methods .............................................................................................................. 75
GetImage Method ........................................................................................... 77
GetImage(ImageFormat) Method ............................................................... 78
GetImage(ImageFormat,Int32,Int32) Method ............................................ 79
Properties............................................................................................................ 80
BackColor Property ......................................................................................... 85
CodeVersion Property ..................................................................................... 85
Encoding Property........................................................................................... 86
EncodingException Property ........................................................................... 87
ErrorCorrectionLevel Property ........................................................................ 87
ForeColor Property ......................................................................................... 88
Image Property ............................................................................................... 89
SizeMode Property ......................................................................................... 89
SymbolSize Property ....................................................................................... 90
Text Property .................................................................................................. 91
Strings ..................................................................................................................... 91
Overview ............................................................................................................. 92
Members ............................................................................................................. 93
Properties............................................................................................................ 93
ResourceManager Property ............................................................................ 94
UICulture Property .......................................................................................... 94
Strings.Errors........................................................................................................... 94
Overview ............................................................................................................. 95
Members ............................................................................................................. 96

Properties............................................................................................................ 96
BarHeightMustBePositive Property ................................................................ 97
BarNarrowMustBePositive Property .............................................................. 98
BarWideMustBePositive Property .................................................................. 98
InvalidCodeVersion Property .......................................................................... 98
InvalidSymbolSize Property ............................................................................ 99
Enumerations .............................................................................................................. 99
BarDirectionEnum ................................................................................................... 99
CodeTypeEnum ..................................................................................................... 100
Encoding................................................................................................................ 103
ErrorCorrectionLevel ............................................................................................. 104

BarCode for WinForms Overview


The new barcode engine provides a stand-alone control, C1BarCode, that implements
more standard barcode types than the old version. The new C1.Win.Barcode assembly replaces
C1BarCode and C1QRCode controls with a single C1BarCode control that uses a different
codebase.
In case if you are not ready to upgrade, the old C1.Win.C1Barcode assembly remains included
into our toolset. You can check the documentation for the old barcode here.
Unlike barcode fonts, BarCode for WinForms automatically adds any necessary control
symbols and checksums to the value being encoded, depending on the encoding being used,
to eliminate reader errors. You can use several standard barcodes for adding barcode images to
grid cells, to Web pages, or to regular .NET PrintDocument objects. You can also deploy
BarCode for WinForms with your applications like any regular assembly. Because it is a royaltyfree DLL, you do not have to worry about installing barcode fonts on the client-side and making
sure they are royalty free. And BarCode for WinForms is so easy to use just add the control
to your form, set the encoding type, and you are done!

Key Features

Supports 38 BarCode Symbologies


The C1BarCode control supports 38 standard barcodes for Windows Forms
applications. It also offers several properties that can be set for rendering as well as
customizing barcodes. The FNC1 characters are also supported in some barcodes.
See Using BarCode for WinForms for more information.

Integrated QRCode Format


The QR code (Quick Response code) format is one of the most popular 2D barcode
formats available today, with free readers available for virtually all smart phones. The
C1BarCode control provides the functionality of QR code, so you don't need to add
any additional control.

Automatically Adds Checksums


The C1BarCode control automatically adds necessary control symbols and checksums
to the value being encoded, depending on the symbology being used, to guarantee a
good read on your barcodes.

Royalty-free DLL for Easy Deployment

The C1BarCode is a royalty-free DLL that can be deployed with your applications like
any regular assembly.

BarCode for WinForms Quick Start


This quick start section walks through the steps of adding C1BarCode to your project and
creating a simple barcode application. The quick start demonstrates how various symbologies
available in C1BarCode are rendered on changing the text and the barcode type. For more
information about available symbology, see BarCode Symbology.

See Also
Step 1: Setting Up the Project
Step 2: Adding Code to the Project
Step 3: Running the Project

Step 1: Setting Up the Project


To set up the project and add the C1BarCode control to the form, complete the following steps:
1.
2.

Create a new .NET project.


From the Toolbox, add the following controls:
o C1BarCode
o ComboBox (to contain the list of barcodes available in C1BarCode control)
o TextBox (to enter the text for observing barcodes)
o Label (add three labels for displaying name of the above controls)
You will notice that on adding C1BarCode control, C1.Win.BarCode and C1.Win
assemblies get added to the References folder in the project. If you do not see
C1BarCode control in your Toolbox, do the following:
5.
In Toolbox, right-click a tab and select Choose Items option to open
the Choose Toolbox Items wizard.
6. Click Browse. Navigate through the default installation path: C:\Program Files
(x86)\ComponentOne\WinForms Edition\bin\v4.0, select C1.Win.BarCode.4 dll,
and then click OK.
Click the ComboBox and in the Properties window, rename it as cbCodeType.

Set the Text property of the three Label controls as Code Type, Text, and BarCode,
respectively. Place the controls on the form as shown.

You have just completed the first step toward creating a simple application on BarCode for
WinForms.

Step 2: Adding Code to the Project


To add code to your project, complete the following steps:
1.
2.

Add namespace Imports C1.BarCode (Visual Basic projects) or using C1.BarCode (C#
projects).
Double-click Form1 to create Form1_Load event and switch to the code view. To set
the default text of the TextBox and to populate the ComboBox control with the code
types available in C1BarCode, add the following code.
Visual Basic

Copy Code

Dim types As Array = [Enum].GetValues(GetType(CodeType))


Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
tbText.Text = "HELLO WORLD!"
cbCodeType.DataSource = types
cbCodeType.SelectedIndex = Array.IndexOf(types, CodeType.Code39)
cbCodeType.Select()
End Sub
C#

Copy Code

Array types = Enum.GetValues(typeof(CodeType));

private void Form1_Load(object sender, EventArgs e)


{
tbText.Text = "HELLO WORLD!";
cbCodeType.DataSource = types;
cbCodeType.SelectedIndex = Array.IndexOf(types, CodeType.Code39);
cbCodeType.Select();
}
3.

Click ComboBox on the form. From the events in the Property window, double-click
SelectedIndexChanged to create cbCodeType_SelectedIndexChanged event and add
following code.
Visual Basic

Copy Code

Private Sub cbCodeType_SelectedIndexChanged(sender As Object, e As EventArgs)


Handles cbCodeType.SelectedIndexChanged
C1BarCode1.CodeType = DirectCast(cbCodeType.SelectedValue, CodeType)
End Sub
C#

Copy Code

private void cbCodeType_SelectedIndexChanged(object sender, EventArgs e)


{
c1BarCode1.CodeType = (CodeType)cbCodeType.SelectedValue;
}
4.

Click the TextBox control on the form. From the events in the Property window,
double-click TextChanged to create the tbText_TextChanged event and add following
code to the event.
Visual Basic

Copy Code

Private Sub tbText_TextChanged(sender As Object, e As EventArgs) Handles


tbText.TextChanged
C1BarCode1.Text = tbText.Text
End Sub
C#

Copy Code

private void tbText_TextChanged(object sender, EventArgs e)

{
c1BarCode1.Text = tbText.Text;
}
In this step, you added functionality to the controls. In the next step, you will run the project
and observe runtime interactions.

Step 3: Running the Project


Now that you set up the project and added code, let's run the project to view code
types supported by BarCode for WinForms.
Complete the following steps:
1.

Run the project and select code type from the ComboBox.

2.

Select different code types and notice the corresponding barcodes displayed.

3.

Try entering different text strings of alpha numeric characters. If a text is not supported
by the barcode, an error message is displayed as in image below.

Congratulation! You have completed the quick start in which you created a simple
application for viewing different barcodes supported in BarCode for WinForms.
Note that some encodings have a minimum character requirement, while others work
only with numeric values. For more information about supported barcode symbologies,
see BarCode Symbology.

Using BarCode for WinForms


The new barcode engine lets you integrate various industry-standard barcodes into the
Windows Forms applications. For understanding the working of barcodes, it is important to
have knowledge of the barcode symbologies and the properties or options associated with
them.

See Also
BarCode Symbology
BarCode Options

BarCode Symbology
The barcode symbology specifies the encoding scheme used to convert character data into the
pattern of wide and narrow bars, and spaces in a barcode. The following table illustrates the
barcode symbology provided by CodeType property in BarCode for WinForms.
Code Type
Ansi39

Example

Description
ANSI 3 of 9 (Code 39) uses
upper case, numbers, - , *
$ / + %. This is the default
barcode style.

Ansi39x

ANSI Extended 3 of 9
(Extended Code 39) uses
the complete ASCII
character set.

Codabar

Codabar uses A B C D + : . / $ and numbers.

Code_128_A

Code 128 A uses control


characters, numbers,
punctuation, and upper
case.

Code_128_B

Code 128 B uses


punctuation, numbers,
upper case and lower case.

Code_128_C

Code 128 C uses only


numbers.

Code_128auto

Code 128 Auto uses the


complete ASCII character
set. Automatically selects
between Code 128 A, B,
and C to give the smallest
barcode.

Code_2_of_5

Code 2 of 5 uses only


numbers.

Code93

Code 93 uses uppercase, %


$ * / , + -, and numbers.

Code25intlv

Interleaved 2 of 5 uses
only numbers.

Code39

Code 39 uses numbers, % *


$ /. , - +, and upper case.

Code39x

Extended Code 39 uses the


complete ASCII character
set.

Code49

Code 49 is a 2D highdensity stacked barcode


containing two to eight
rows of eight characters
each. Each row has a start

code and a stop code.


Encodes the complete
ASCII character set.
Code93x

Extended Code 93 uses the


complete ASCII character
set.

DataMatrix

Data Matrix is a high


density, two-dimensional
barcode with square
modules arranged in a
square or rectangular
matrix pattern.

EAN_13

EAN-13 uses only numbers


(12 numbers and a check
digit). It takes only 12
numbers as a string to
calculate a check digit
(CheckSum) and add it to
the thirteenth position. The
check digit is an additional
digit used to verify that a
bar code has been scanned
correctly. The check digit is
added automatically when
the CheckSum property is
set to True.

EAN_8

EAN-8 uses only numbers


(7 numbers and a check
digit).

EAN128FNC1

EAN-128 is an
alphanumeric onedimensional representation

of Application Identifier
(AI) data for marking
containers in the shipping
industry.
This type of bar code
contains the following
sections:

Leading quiet zone


(blank area)

Code 128 start


character

FNC (function) 1
character which
allows scanners to
identify this as an
EAN-128 barcode

Data (AI plus data


field)

Symbol check
character (Start
code value plus
product of each
character position
plus value of each
character divided
by 103. The
checksum is the
remainder value.)

Stop character

Trailing quiet zone


(blank area)

The AI in the Data section


sets the type of the data to
follow (i.e. ID, dates,
quantity, measurements,

etc.). There is a specific


data structure for each
type of data. This AI is
what distinguishes the
EAN-128 code from Code
128.
Multiple AIs (along with
their data) can be
combined into a single bar
code.
EAN128FNC1 is a
UCC/EAN-128 (EAN128)
type barcode that allows
you to insert FNC1
character at any place and
adjust the bar size, etc.,
which is not available in
UCC/EAN-128.
To insert FNC1 character,
set \n for C#, or vbLf
for VB to Text property at
runtime.
IntelligentMail

Intelligent Mail, formerly


known as the 4-State
Customer Barcode, is a 65bar code used for
domestic mail in the U.S.

JapanesePostal

This is the barcode used by


the Japanese Postal
system. Encodes alpha and
numeric characters
consisting of 18 digits
including a 7-digit postal

code number, optionally


followed by block and
house number information.
The data to be encoded
can include hyphens.
Matrix_2_of_5

Matrix 2 of 5 is a higher
density barcode consisting
of 3 black bars and 2 white
bars.

MicroPDF417

MicroPDF417 is twodimensional (2D), multirow symbology, derived


from PDF417. MicroPDF417 is designed for
applications that need to
encode data in a twodimensional (2D) symbol
(up to 150 bytes, 250
alphanumeric characters,
or 366 numeric digits) with
the minimal symbol size.
MicroPDF417 allows you to
insert an FNC1 character as
a field separator for
variable length Application
Identifiers (AIs).
To insert FNC1 character,
set \n for C#, or vbLf
for VB to Text property at
runtime.

MSI

MSI Code uses only


numbers.

Pdf417

Pdf417 is a popular highdensity 2-dimensional


symbology that encodes
up to 1108 bytes of
information. This barcode
consists of a stacked set of
smaller barcodes. Encodes
the full ASCII character set.
It has ten error correction
levels and three data
compaction modes: Text,
Byte, and Numeric. This
symbology can encode up
to 1,850 alphanumeric
characters or 2,710
numeric characters.

PostNet

PostNet uses only numbers


with a check digit.

QRCode

QRCode is a 2D symbology
that is capable of handling
numeric, alphanumeric and
byte data as well as
Japanese kanji and kana
characters. This symbology
can encode up to 7,366
characters.

RM4SCC

Royal Mail RM4SCC uses


only letters and numbers
(with a check digit). This is
the barcode used by the
Royal Mail in the United
Kingdom.

RSS14

RSS14 is a 14-digit
Reduced Space Symbology
that uses EAN.UCC item
identification for point-ofsale omnidirectional
scanning.

RSS14Stacked

RSS14Stacked uses the


EAN.UCC information with
Indicator digits as in the
RSS14Truncated, but
stacked in two rows for a
smaller width.
RSS14Stacked allows you
to set Composite Options,
where you can select the
type of the barcode in the
Type drop-down list and
the value of the composite
barcode in the Value field.

RSS14StackedOmnidirectio

RSS14StackedOmnidirectio

nal

nal uses the EAN.UCC


information with
omnidirectional scanning
as in the RSS14, but
stacked in two rows for a
smaller width.

RSS14Truncated

RSS14Truncated uses the


EAN.UCC information as in
the RSS14, but also
includes Indicator digits of
zero or one for use on
small items not scanned at
the point of sale.

RSSExpanded

RSSExpanded uses the


EAN.UCC information as in
the RSS14, but also adds AI
elements such as weight
and best-before dates.
RSSExpanded allows you
to insert an FNC1 character
as a field separator for
variable length Application
Identifiers (AIs).
To insert FNC1 character,
set \n for C#, or vbLf
for VB to Text property at
runtime.

RSSExpandedStacked

RSSExpandedStacked uses
the EAN.UCC information
with AI elements as in the
RSSExpanded, but stacked
in two rows for a smaller
width.
RSSExpandedStacked
allows you to insert an
FNC1 character as a field
separator for variable
length Application
Identifiers (AIs).
To insert FNC1 character,
set \n for C#, or vbLf
for VB to Text property at
runtime.

RSSLimited

RSS Limited uses the


EAN.UCC information as in
the RSS14, but also

includes Indicator digits of


zero or one for use on
small items not scanned at
the point of sale.
RSSLimited allows you to
set Composite Options,
where you can select the
type of the barcode in the
Type drop-down list and
the value of the composite
barcode in the Value field.
UCCEAN128

UCC/EAN 128 uses the


complete ASCII character
Set. This is a special
version of Code 128 used
in HIBC applications.

UPC_A

UPC-A uses only numbers


(11 numbers and a check
digit).

UPC_E0

UPC-E0 uses only numbers.


Used for zero-compression
UPC symbols. For the
Caption property, you may
enter either a six-digit
UPC-E code or a complete
11-digit (includes code
type, which must bezero)
UPC-A code. If an 11-digit
code is entered, the
Barcode control will
convert it to a six-digit
UPC-E code, if possible. If
it is not possible to convert
from the 11-digit code to

the six-digit code, nothing


is displayed.
UPC_E1

UPC-E1 uses only numbers.


Used typically for shelf
labeling in the retail
environment. The length of
the input string for U.P.C.
E1 is six numeric
characters.

Note that the following barcodes support FNC1 characters:

EAN128FNC1
MicroPDF417
RSSExpanded
RSSExpandedStacked

BarCode Options
The C1BarCode provides several options that are common to all barcodes or specific to certain
barcodes. These options are used to customize the appearance of C1BarCode.
The common options exposed by C1.Win.BarCode assembly for rendering barcodes in
WinForms are as follows:

BarDirection: Lets you select the barcode's direction. The available options are:
o LeftToRight: The barcode symbol is printed left to right (default).
o RightToLeft: The barcode symbol is printed right to left.
o TopToBottom: The barcode symbol is printed top to bottom.
o BottomToTop: The barcode symbol is printed bottom to top.
BarHeight: Lets you specify the height of a barcode in screen pixels. If the bar height
exceeds the height of the control, this property is ignored.
CodeType: Lets you select encoding that should be applied to the value stored in the
Text property to generate the barcode image.
CaptionAlignment: Lets you select the display position of the value of barcode. The
available options are Left, Right, and Center.
CaptionGrouping: Lets you specify a value indicating whether to add spaces between
groups of characters in the caption to make long numbers easier to read.
CaptionPosition: Lets you select the caption's vertical position relative to the barcode
symbol. The available options are None, Above, and Below.
Image: Gets an image of the barcode that represents the value in the Text property,
obtained using the encoding specified by the CodeType property.

ModuleSize: Lets you specify the module (narrowest bar width) of a barcode in screen
pixels. The width of wide bars is counted automatically depending on the barcode type.

QuietZone: Lets you specify the quiet zone(s) in a barcode. A quiet zone is an area of
blank space on either side of a barcode that tells the scanner where the symbology
starts and stops. The options available are as follows:
o Left: Enter the size of blank space to leave to the left of the barcode.
o Right: Enter the size of blank space to leave to the right of the barcode.
o Top: Enter the size of blank space to leave at the top of the barcode.
o Bottom: Enter the size of blank space to leave at the bottom of the barcode.
The following image shows Left and Right quiet zones:

Text: Lets you specify the value that is encoded as a barcode image.
WholeSize: Lets you specify the size of the overall barcode. WholeWidth represents the
width and WholeHeight represents the height of the overall barcode.

FixLength: Lets you specify the fixed number of digits of values of the barcode. It takes
the integer value.

AutoSize: Lets you specify whether the barcode should stretch to fit the control. It
takes the value True or False.
When AutoSize is set to True,
o the barcode automatically stretches to fit the control.
o the readable size is calculated by the barcode itself.
o the size of Matrix barcodes is calculated by OnCalculateSize method.
o the size of the non-matrix bardodes, it is calculated by BarHeight and
ModuleSize.
When AutoSize is set to False,
o
o
o

the size size of the barcode is determined by Width or Height properties.


the control gets clipped if the BarHeight is larger than control's height
some empty space between the barcode and the control is left if the BarHeight
is smaller than height,

The options that are specific to the type of barcodes are as follows:
CheckSumEnabled: Lets you specify whether the check digits are automatically added or not.
When data to be bound already includes check digits, programmers sometimes want to prevent
controls from automatically including them. This property is supported for Code49, Code128,
PostNet5/9/11, and JapanesePostal barcodes.
Ean128Fnc1Options:

Dpi: Lets you specify the resolution of the printer. It takes the integer value.
BarAdjust: Lets you specify the adjustment size by dot.
ModuleSize: Lets you specify the horizontal size of the barcode module. It takes the
integer value.

Code25intlvOptions:

BearBar: Lets you select whether or not to display bearer bar to ITF (Interleaved Two of
Five) barcode. It takes the value True or False.
LineStroke: Lets you select the color of the bearer bar.
LineStrokeThickness: Lets you select the line width of the bearer bar. It takes the
integer values.

Code49Options:

Grouping: Lets you use grouping in the barcode. Its value is either True or False.
Group: Obtains or sets group numbers for barcode grouping. Its value is between 0
and 8. If the value of Grouping is True, the range of value of Group is from 0 to 8. If the
value of Grouping is False, value of Group is 0. If the value of Grouping is True, and the
Group value is smaller than 0 or larger than 8, the
BarCodeException.EnumErrorCode.Code49GroupNo will be thrown.

DataMatrixOptions:

EccMode: Lets you select the ECC mode. The possible values are ECC000, ECC050,
ECC080, ECC100, ECC140, or ECC200.

Ecc200SymbolSize: Lets you select the size of ECC200 symbol. The default value is
SquareAuto.
Ecc200EncodingMode: Lets you select the ECC200 encoding mode. The possible
values are Auto, ASCII, C40, Text, X12, EDIFACT, or Base256.
Ecc000_140SymbolSize: Lets you select the size of the ECC000_140 symbol.
StructuredAppend: Lets you select whether the current barcode symbol is part of
structured append symbols.
StructureNumber: Lets you specify the structure number of current symbol within the
structured append symbols. The range of this value is from 0 to 15.
FileIdentifier: Lets you specify the file identifier of a related group of structured
append symbols. The valid file indentifier value should be within [1,254]. Setting file
identifier to 0 lets the file identifier to be calculated automatically.

GS1CompositeOptions:

Type: Lets you select the composite symbol type. Its value can be None or CCA. CCA
(Composite Component - Version A) is the smallest variant of the 2-dimensional
composite component.
Value: Lets you specify the CCA character data.

MicroPDF417Options:

CompactionMode: Lets you select the type of CompactionMode. The possible values
are Auto, TextCompactionMode, NumericCompactionMode, and
ByteCompactionMode.
FileID: Lets you specify the file id of structured append symbol. It takes the value from
0 to 899. If this value is smaller than 0 or larger than 899, the
BarCodeException.EnumErrorCode.MicroPDF417FileID is thrown.
SegmentCount: Lets you specify the segment count of structured append symbol. It
takes the value from 0 to 99999. If this value is smaller than 0 or larger than 99999, the
BarCodeException.EnumErrorCode.MicroPDF417SegmentCount is thrown.
SegmentIndex: Lets you specify the segment index of structured append symbol. It
takes the value from 0 to 99998 and less than the value of segment count. If this value
is smaller than 0 or larger than 99998, the
BarCodeException.EnumErrorCode.MicroPDF417SegmentIndex is thrown.
Version: Lets you select the symbol size. The default value is ColumnPriorAuto.

PDF417Options:

Column: Lets you specify the column numbers for the barcode. It takes the integer
value; the default value is -1 and the range of this value is 1 to 30. If this value is not
equal to -1 or smaller than 1 or larger than 30, the
BarCodeException.EnumErrorCode.PDF417Col is thrown.
Row: Lets you specify the row numbers for the barcode. It takes the integer value; the
default value is -1 and the range of this value is from 3 to 90. If this value is not equal
to -1 or smaller than 3 or larger than 90, the
BarCodeException.EnumErrorCode.PDF417Row is thrown.
ErrorLevel: Lets you specify the error correction level for the barcode. It takes
the integer value; the value is -1 or the range of this value is from 0 to 8. If this value is
not equal to -1 or is smaller than 0 or larger than 8, the
BarCodeException.EnumErrorCode.PDF417ErrorLevel is thrown.

And Level 0 is low strength and the default value is -1.


Type: Lets you select the type of PDF417 barcode. The available types are Normal and
Simple.

QRCodeOptions:

Model: Lets you select the model of QRCode. The available models are Model1 and
Model2.
ErrorLevel: Lets you select the error correction level for the barcode. The available
options are Low, Medium, Quality, and High.
Version: Lets you specify the version of the barcode.
Mask: Lets you select the pattern used for masking barcode. In order to make sure
QRCode being successfully read, mask process is required to balance brightness. The
options available are Auto, Mask000, Mask001, Mask010, Mask011, Mask100, Mask101,
Mask110, and Mask111. The following image shows masking in QRCode:

Connection: Lets you select whether connection is used for the barcode. It takes the
value True of False.
ConnectionNumber: Lets you specify the connection number for the barcode. It takes
the integer value ranging from 0 to 15. If this value is smaller than 0 or larger than 15,
EnumErrorCode.QRCodeConnectionNo exception will be thrown.
Encoding: Lets you select the encoding for the barcode. It takes the integer value. The
value is -1 or the range is from 1 to 14 when the Model property is set to Model1. The
value is -1 or the range is from 1 to 40 when the Model property is set to Model2.

RssExpandedStackedOptions:

RowCount: Lets you specify the number of stacked rows. It takes the integer value; the
range is from 1 to 11. If this value is smaller than 1 or larger than 11, the
BarCodeException.EnumErrorCode.RSSExpandedStackedCount is thrown.

Customizing the C1BarCode Control


The Property window provides many design time options to customize the overall appearance
of the C1BarCode control. These options depend on the type of barcode used in an application.
You can also perform run time customization on C1BarCode control using the PropertyGrid
control. See the following steps to customize the C1BarCode control during run time. This
code uses the sample created in the BarCode for WinForms Quick Start section.
1.
2.

Add PropertyGrid control to the form.


Add following code to the Form_Load event.

Visual Basic

Copy Code

PropertyGrid1.SelectedObject = C1BarCode1
C#

Copy Code

propertyGrid1.SelectedObject = c1BarCode1;
3.

4.

The above code sets the PropertyGrid to display the options available in the
C1BarCode.
Run the project. The following images shows the CodeType set to the QRCode and the
Text set to a URL.

API Reference
The following topics contain the API reference for BarCode for WinForms.

C1.Win.C1BarCode.4 Assembly
Namespaces
C1.Win.C1BarCode Namespace
Overview
Inheritance Hierarchy
C1.Win.C1BarCode.4 Assembly : C1.Win.C1BarCode Namespace

Classes
Class

Description

C1BarCode

Creates barcode representations of alphanumeric values.

C1QRCode

Creates QR barcode representations of alphanumeric values.

Strings

Static class containing UI strings used by the designer.

Strings.Errors

Enumerations
Enumeration

Description

BarDirectionEnum

Specifies the direction of the barcode

CodeTypeEnum

Specifies the type of barcode to be generated by the C1BarCode


control.

Encoding

Specifies the type of encoding to use (more flexible encodings


consume more space).

ErrorCorrectionLevel Specifies the error-correction level (higher levels consume more


space).

See Also

Reference
C1.Win.C1BarCode.4 Assembly

Classes
C1BarCode
Members Example
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1BarCode Class

Creates barcode representations of alphanumeric values.

Object Model

Syntax
Visual Basic (Declaration)
Public Class C1BarCode
Inherits System.Windows.Forms.Control
C#
public class C1BarCode : System.Windows.Forms.Control

Remarks
To use the C1BarCode control, set the CodeType property to the type of encoding you want to
use, then set the Text property to the value you want to encode.
The control will show the barcode image. If you want to include the barcode in a document, use
the Image property to retrieve a resolution-independent image of the barcode.

Example
This sample shows how to use the Text property to encode the value "123456" as a Code39encoded barcode.

C#

c1barcode1.CodeType = CodeTypeEnum.Code39;
c1barcode1.Text = "123456";
pictureBox1.Image = c1barcode1.Image;

Inheritance Hierarchy

System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
C1.Win.C1BarCode.C1BarCode

See Also
Reference
C1BarCode Members
C1.Win.C1BarCode Namespace

Overview
Members Example
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1BarCode Class

Creates barcode representations of alphanumeric values.

Object Model

Syntax
Visual Basic (Declaration)
Public Class C1BarCode
Inherits System.Windows.Forms.Control
C#
public class C1BarCode : System.Windows.Forms.Control

Remarks
To use the C1BarCode control, set the CodeType property to the type of encoding you want to
use, then set the Text property to the value you want to encode.
The control will show the barcode image. If you want to include the barcode in a document, use
the Image property to retrieve a resolution-independent image of the barcode.

Example
This sample shows how to use the Text property to encode the value "123456" as a Code39encoded barcode.

C#

c1barcode1.CodeType = CodeTypeEnum.Code39;
c1barcode1.Text = "123456";
pictureBox1.Image = c1barcode1.Image;

Inheritance Hierarchy
System.Object
System.MarshalByRefObject

System.ComponentModel.Component
System.Windows.Forms.Control
C1.Win.C1BarCode.C1BarCode

See Also
Reference
C1BarCode Members
C1.Win.C1BarCode Namespace

Members
Properties Methods Events
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1BarCode Class

The following tables list the members exposed by C1BarCode.

Public Constructors
Name

Description

C1BarCode Constructor Creates a new instance of the C1BarCode control.


Top

Public Properties
Name

Description

AccessibilityObject

(Inherited from System.Windows.Forms.Control)

AccessibleDefaultActionDescription (Inherited from System.Windows.Forms.Control)


AccessibleDescription

(Inherited from System.Windows.Forms.Control)

AccessibleName

(Inherited from System.Windows.Forms.Control)

AccessibleRole

(Inherited from System.Windows.Forms.Control)

AllowDrop

(Inherited from System.Windows.Forms.Control)

Anchor

(Inherited from System.Windows.Forms.Control)

AutoScrollOffset

(Inherited from System.Windows.Forms.Control)

BackColor

Overridden. Gets or sets the background color for the


control.

BackgroundImage

(Inherited from System.Windows.Forms.Control)

BackgroundImageLayout

(Inherited from System.Windows.Forms.Control)

BarDirection

Gets or sets the direction of the barcode.

BarHeight

Gets or sets the height of the bars in screen pixels.

BarNarrow

Gets or sets the width of the narrow bars in screen


pixels.

BarWide

Gets or sets the width of the wide bars in screen pixels.

BindingContext

(Inherited from System.Windows.Forms.Control)

Bottom

(Inherited from System.Windows.Forms.Control)

Bounds

(Inherited from System.Windows.Forms.Control)

CanFocus

(Inherited from System.Windows.Forms.Control)

CanSelect

(Inherited from System.Windows.Forms.Control)

Capture

(Inherited from System.Windows.Forms.Control)

CausesValidation

(Inherited from System.Windows.Forms.Control)

ClientRectangle

(Inherited from System.Windows.Forms.Control)

ClientSize

(Inherited from System.Windows.Forms.Control)

CodeType

Gets or sets the type of encoding to use when


generating the barcode image.

CompanyName

(Inherited from System.Windows.Forms.Control)

Container

(Inherited from System.ComponentModel.Component)

ContainsFocus

(Inherited from System.Windows.Forms.Control)

ContextMenu

(Inherited from System.Windows.Forms.Control)

ContextMenuStrip

(Inherited from System.Windows.Forms.Control)

Controls

(Inherited from System.Windows.Forms.Control)

Created

(Inherited from System.Windows.Forms.Control)

Cursor

(Inherited from System.Windows.Forms.Control)

DataBindings

(Inherited from System.Windows.Forms.Control)

DisplayRectangle

(Inherited from System.Windows.Forms.Control)

Disposing

(Inherited from System.Windows.Forms.Control)

Dock

(Inherited from System.Windows.Forms.Control)

Enabled

(Inherited from System.Windows.Forms.Control)

EncodingException

Gets the System.Exception that prevented the Text


from being encoded.

Focused

(Inherited from System.Windows.Forms.Control)

Font

Overridden. Gets or sets the Font used to display the


value of the Text property.

ForeColor

Overridden. Gets or sets the foreground color for the


control.

Handle

(Inherited from System.Windows.Forms.Control)

HasChildren

(Inherited from System.Windows.Forms.Control)

Height

(Inherited from System.Windows.Forms.Control)

Image

Gets an image of the barcode that represents the


value in the Text property, obtained using the
encoding specified by the CodeType property.

ImeMode

(Inherited from System.Windows.Forms.Control)

InvokeRequired

(Inherited from System.Windows.Forms.Control)

IsAccessible

(Inherited from System.Windows.Forms.Control)

IsDisposed

(Inherited from System.Windows.Forms.Control)

IsHandleCreated

(Inherited from System.Windows.Forms.Control)

IsMirrored

(Inherited from System.Windows.Forms.Control)

LayoutEngine

(Inherited from System.Windows.Forms.Control)

Left

(Inherited from System.Windows.Forms.Control)

Location

(Inherited from System.Windows.Forms.Control)

Margin

(Inherited from System.Windows.Forms.Control)

MaximumSize

(Inherited from System.Windows.Forms.Control)

MinimumSize

(Inherited from System.Windows.Forms.Control)

Name

(Inherited from System.Windows.Forms.Control)

Padding

(Inherited from System.Windows.Forms.Control)

Parent

(Inherited from System.Windows.Forms.Control)

PreferredSize

(Inherited from System.Windows.Forms.Control)

ProductName

(Inherited from System.Windows.Forms.Control)

ProductVersion

(Inherited from System.Windows.Forms.Control)

RecreatingHandle

(Inherited from System.Windows.Forms.Control)

Region

(Inherited from System.Windows.Forms.Control)

Right

(Inherited from System.Windows.Forms.Control)

RightToLeft

(Inherited from System.Windows.Forms.Control)

ShowText

Gets or sets whether the value of the Text property


should be displayed along with the barcode image.

Site

(Inherited from System.Windows.Forms.Control)

Size

(Inherited from System.Windows.Forms.Control)

SizeMode

Gets or sets how the barcode image is displayed


within the control.

TabIndex

(Inherited from System.Windows.Forms.Control)

TabStop

(Inherited from System.Windows.Forms.Control)

Tag

(Inherited from System.Windows.Forms.Control)

Text

Overridden. Gets or sets the value that is encoded as a


barcode image.

Top

(Inherited from System.Windows.Forms.Control)

TopLevelControl

(Inherited from System.Windows.Forms.Control)

UseWaitCursor

(Inherited from System.Windows.Forms.Control)

Visible

(Inherited from System.Windows.Forms.Control)

Width

(Inherited from System.Windows.Forms.Control)

Top

Public Methods
Name

Description

BeginInvoke

Overloaded. (Inherited from System.Windows.Forms.Control)

BringToFront

(Inherited from System.Windows.Forms.Control)

Contains

(Inherited from System.Windows.Forms.Control)

CreateControl

(Inherited from System.Windows.Forms.Control)

CreateGraphics

(Inherited from System.Windows.Forms.Control)

CreateObjRef

(Inherited from System.MarshalByRefObject)

Dispose

(Inherited from System.ComponentModel.Component)

DoDragDrop

(Inherited from System.Windows.Forms.Control)

DrawToBitmap

(Inherited from System.Windows.Forms.Control)

EndInvoke

(Inherited from System.Windows.Forms.Control)

FindForm

(Inherited from System.Windows.Forms.Control)

Focus

(Inherited from System.Windows.Forms.Control)

GetChildAtPoint

Overloaded. (Inherited from System.Windows.Forms.Control)

GetContainerControl

(Inherited from System.Windows.Forms.Control)

GetImage

Overloaded. Gets an image of the barcode that represents the


value in the Text property, obtained using the encoding
specified by the CodeType property.

GetLifetimeService

(Inherited from System.MarshalByRefObject)

GetNextControl

(Inherited from System.Windows.Forms.Control)

GetPreferredSize

(Inherited from System.Windows.Forms.Control)

Hide

(Inherited from System.Windows.Forms.Control)

InitializeLifetimeService

(Inherited from System.MarshalByRefObject)

Invalidate

Overloaded. (Inherited from System.Windows.Forms.Control)

Invoke

Overloaded. (Inherited from System.Windows.Forms.Control)

PerformLayout

Overloaded. (Inherited from System.Windows.Forms.Control)

PointToClient

(Inherited from System.Windows.Forms.Control)

PointToScreen

(Inherited from System.Windows.Forms.Control)

PreProcessControlMessage (Inherited from System.Windows.Forms.Control)


PreProcessMessage

(Inherited from System.Windows.Forms.Control)

RectangleToClient

(Inherited from System.Windows.Forms.Control)

RectangleToScreen

(Inherited from System.Windows.Forms.Control)

Refresh

(Inherited from System.Windows.Forms.Control)

ResetText

(Inherited from System.Windows.Forms.Control)

ResumeLayout

Overloaded. (Inherited from System.Windows.Forms.Control)

Scale

(Inherited from System.Windows.Forms.Control)

Select

(Inherited from System.Windows.Forms.Control)

SelectNextControl

(Inherited from System.Windows.Forms.Control)

SendToBack

(Inherited from System.Windows.Forms.Control)

SetBounds

Overloaded. (Inherited from System.Windows.Forms.Control)

Show

(Inherited from System.Windows.Forms.Control)

SuspendLayout

(Inherited from System.Windows.Forms.Control)

ToString

(Inherited from System.ComponentModel.Component)

Update

(Inherited from System.Windows.Forms.Control)

Top

Public Events
Name

Description

BackColorChanged

(Inherited from System.Windows.Forms.Control)

BackgroundImageChanged

(Inherited from System.Windows.Forms.Control)

BackgroundImageLayoutChanged (Inherited from System.Windows.Forms.Control)

BindingContextChanged

(Inherited from System.Windows.Forms.Control)

CausesValidationChanged

(Inherited from System.Windows.Forms.Control)

ChangeUICues

(Inherited from System.Windows.Forms.Control)

Click

(Inherited from System.Windows.Forms.Control)

ClientSizeChanged

(Inherited from System.Windows.Forms.Control)

ContextMenuChanged

(Inherited from System.Windows.Forms.Control)

ContextMenuStripChanged

(Inherited from System.Windows.Forms.Control)

ControlAdded

(Inherited from System.Windows.Forms.Control)

ControlRemoved

(Inherited from System.Windows.Forms.Control)

CursorChanged

(Inherited from System.Windows.Forms.Control)

Disposed

(Inherited from System.ComponentModel.Component)

DockChanged

(Inherited from System.Windows.Forms.Control)

DoubleClick

(Inherited from System.Windows.Forms.Control)

DragDrop

(Inherited from System.Windows.Forms.Control)

DragEnter

(Inherited from System.Windows.Forms.Control)

DragLeave

(Inherited from System.Windows.Forms.Control)

DragOver

(Inherited from System.Windows.Forms.Control)

EnabledChanged

(Inherited from System.Windows.Forms.Control)

Enter

(Inherited from System.Windows.Forms.Control)

FontChanged

(Inherited from System.Windows.Forms.Control)

ForeColorChanged

(Inherited from System.Windows.Forms.Control)

GiveFeedback

(Inherited from System.Windows.Forms.Control)

GotFocus

(Inherited from System.Windows.Forms.Control)

HandleCreated

(Inherited from System.Windows.Forms.Control)

HandleDestroyed

(Inherited from System.Windows.Forms.Control)

HelpRequested

(Inherited from System.Windows.Forms.Control)

ImeModeChanged

(Inherited from System.Windows.Forms.Control)

Invalidated

(Inherited from System.Windows.Forms.Control)

KeyDown

(Inherited from System.Windows.Forms.Control)

KeyPress

(Inherited from System.Windows.Forms.Control)

KeyUp

(Inherited from System.Windows.Forms.Control)

Layout

(Inherited from System.Windows.Forms.Control)

Leave

(Inherited from System.Windows.Forms.Control)

LocationChanged

(Inherited from System.Windows.Forms.Control)

LostFocus

(Inherited from System.Windows.Forms.Control)

MarginChanged

(Inherited from System.Windows.Forms.Control)

MouseCaptureChanged

(Inherited from System.Windows.Forms.Control)

MouseClick

(Inherited from System.Windows.Forms.Control)

MouseDoubleClick

(Inherited from System.Windows.Forms.Control)

MouseDown

(Inherited from System.Windows.Forms.Control)

MouseEnter

(Inherited from System.Windows.Forms.Control)

MouseHover

(Inherited from System.Windows.Forms.Control)

MouseLeave

(Inherited from System.Windows.Forms.Control)

MouseMove

(Inherited from System.Windows.Forms.Control)

MouseUp

(Inherited from System.Windows.Forms.Control)

MouseWheel

(Inherited from System.Windows.Forms.Control)

Move

(Inherited from System.Windows.Forms.Control)

PaddingChanged

(Inherited from System.Windows.Forms.Control)

Paint

(Inherited from System.Windows.Forms.Control)

ParentChanged

(Inherited from System.Windows.Forms.Control)

PreviewKeyDown

(Inherited from System.Windows.Forms.Control)

QueryAccessibilityHelp

(Inherited from System.Windows.Forms.Control)

QueryContinueDrag

(Inherited from System.Windows.Forms.Control)

RegionChanged

(Inherited from System.Windows.Forms.Control)

Resize

(Inherited from System.Windows.Forms.Control)

RightToLeftChanged

(Inherited from System.Windows.Forms.Control)

SizeChanged

(Inherited from System.Windows.Forms.Control)

StyleChanged

(Inherited from System.Windows.Forms.Control)

SystemColorsChanged

(Inherited from System.Windows.Forms.Control)

TabIndexChanged

(Inherited from System.Windows.Forms.Control)

TabStopChanged

(Inherited from System.Windows.Forms.Control)

TextChanged

(Inherited from System.Windows.Forms.Control)

Validated

(Inherited from System.Windows.Forms.Control)

Validating

(Inherited from System.Windows.Forms.Control)

VisibleChanged

(Inherited from System.Windows.Forms.Control)

Top

See Also
Reference
C1BarCode Class
C1.Win.C1BarCode Namespace

C1BarCode Constructor
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : C1BarCode
Constructor

Creates a new instance of the C1BarCode control.

Syntax
Visual Basic (Declaration)
Public Function New()
C#
public C1BarCode()

See Also
Reference

C1BarCode Class
C1BarCode Members

Methods
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1BarCode Class

For a list of all members of this type, see C1BarCode members.

Public Methods
Name

Description

BeginInvoke

Overloaded. (Inherited from System.Windows.Forms.Control)

BringToFront

(Inherited from System.Windows.Forms.Control)

Contains

(Inherited from System.Windows.Forms.Control)

CreateControl

(Inherited from System.Windows.Forms.Control)

CreateGraphics

(Inherited from System.Windows.Forms.Control)

CreateObjRef

(Inherited from System.MarshalByRefObject)

Dispose

(Inherited from System.ComponentModel.Component)

DoDragDrop

(Inherited from System.Windows.Forms.Control)

DrawToBitmap

(Inherited from System.Windows.Forms.Control)

EndInvoke

(Inherited from System.Windows.Forms.Control)

FindForm

(Inherited from System.Windows.Forms.Control)

Focus

(Inherited from System.Windows.Forms.Control)

GetChildAtPoint

Overloaded. (Inherited from System.Windows.Forms.Control)

GetContainerControl

(Inherited from System.Windows.Forms.Control)

GetImage

Overloaded. Gets an image of the barcode that represents the


value in the Text property, obtained using the encoding
specified by the CodeType property.

GetLifetimeService

(Inherited from System.MarshalByRefObject)

GetNextControl

(Inherited from System.Windows.Forms.Control)

GetPreferredSize

(Inherited from System.Windows.Forms.Control)

Hide

(Inherited from System.Windows.Forms.Control)

InitializeLifetimeService

(Inherited from System.MarshalByRefObject)

Invalidate

Overloaded. (Inherited from System.Windows.Forms.Control)

Invoke

Overloaded. (Inherited from System.Windows.Forms.Control)

PerformLayout

Overloaded. (Inherited from System.Windows.Forms.Control)

PointToClient

(Inherited from System.Windows.Forms.Control)

PointToScreen

(Inherited from System.Windows.Forms.Control)

PreProcessControlMessage (Inherited from System.Windows.Forms.Control)


PreProcessMessage

(Inherited from System.Windows.Forms.Control)

RectangleToClient

(Inherited from System.Windows.Forms.Control)

RectangleToScreen

(Inherited from System.Windows.Forms.Control)

Refresh

(Inherited from System.Windows.Forms.Control)

ResetText

(Inherited from System.Windows.Forms.Control)

ResumeLayout

Overloaded. (Inherited from System.Windows.Forms.Control)

Scale

(Inherited from System.Windows.Forms.Control)

Select

(Inherited from System.Windows.Forms.Control)

SelectNextControl

(Inherited from System.Windows.Forms.Control)

SendToBack

(Inherited from System.Windows.Forms.Control)

SetBounds

Overloaded. (Inherited from System.Windows.Forms.Control)

Show

(Inherited from System.Windows.Forms.Control)

SuspendLayout

(Inherited from System.Windows.Forms.Control)

ToString

(Inherited from System.ComponentModel.Component)

Update

(Inherited from System.Windows.Forms.Control)

Top

See Also
Reference
C1BarCode Class
C1.Win.C1BarCode Namespace

GetImage Method
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : GetImage Method

Gets an image of the barcode that represents the value in the Text property, obtained using the
encoding specified by the CodeType property.

Overload List
Overload

Description

GetImage(ImageFormat)

Gets an image of the barcode that represents the value in


the Text property, obtained using the encoding specified
by the CodeType property.

GetImage(ImageFormat,Int32,Int32) Gets an image of the barcode that represents the value in


the Text property, obtained using the encoding specified
by the CodeType property.

See Also
Reference
C1BarCode Class
C1BarCode Members

GetImage(ImageFormat) Method
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class > GetImage Method :
GetImage(ImageFormat) Method

An System.Drawing.Imaging.ImageFormat value that specifies the type of image to be


created.
Gets an image of the barcode that represents the value in the Text property, obtained using the
encoding specified by the CodeType property.

Syntax
Visual Basic (Declaration)
Public Overloads Function GetImage( _
ByVal format As System.Drawing.Imaging.ImageFormat _
) As System.Drawing.Image
C#
public System.Drawing.Image GetImage(
System.Drawing.Imaging.ImageFormat format
)

Parameters
format
An System.Drawing.Imaging.ImageFormat value that specifies the type of image to
be created.

Return Value
An image of the barcode with the specified format.

Remarks

The Image property can also be used to obtain an image of the barcode. However, it
always returns a System.Drawing.Imaging.Metafile image of a pre-set size and with a
transparent background. This method returns solid-background bitmaps.

See Also
Reference
C1BarCode Class
C1BarCode Members
Overload List

GetImage(ImageFormat,Int32,Int32) Method
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class > GetImage Method :
GetImage(ImageFormat,Int32,Int32) Method

An System.Drawing.Imaging.ImageFormat value that specifies the type of image to be


created.
The width of the image, in pixels.
The height of the image, in pixels.
Gets an image of the barcode that represents the value in the Text property, obtained using the
encoding specified by the CodeType property.

Syntax
Visual Basic (Declaration)
Public Overloads Function GetImage( _
ByVal format As System.Drawing.Imaging.ImageFormat, _
ByVal width As System.Integer, _
ByVal height As System.Integer _
) As System.Drawing.Image
C#
public System.Drawing.Image GetImage(
System.Drawing.Imaging.ImageFormat format,
System.int width,
System.int height
)

Parameters
format

An System.Drawing.Imaging.ImageFormat value that specifies the type of image to


be created.
width
The width of the image, in pixels.
height
The height of the image, in pixels.

Return Value
An image of the barcode with the specified format and dimensions.

Remarks
The Image property can also be used to obtain an image of the barcode.
However, it always returns a System.Drawing.Imaging.Metafile image of a
pre-set size and with a transparent background. This method returns solidbackground bitmaps.

See Also
Reference
C1BarCode Class
C1BarCode Members
Overload List

Properties
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1BarCode Class

For a list of all members of this type, see C1BarCode members.

Public Properties
Name

Description

AccessibilityObject

(Inherited from System.Windows.Forms.Control)

AccessibleDefaultActionDescription (Inherited from System.Windows.Forms.Control)


AccessibleDescription

(Inherited from System.Windows.Forms.Control)

AccessibleName

(Inherited from System.Windows.Forms.Control)

AccessibleRole

(Inherited from System.Windows.Forms.Control)

AllowDrop

(Inherited from System.Windows.Forms.Control)

Anchor

(Inherited from System.Windows.Forms.Control)

AutoScrollOffset

(Inherited from System.Windows.Forms.Control)

BackColor

Overridden. Gets or sets the background color for the


control.

BackgroundImage

(Inherited from System.Windows.Forms.Control)

BackgroundImageLayout

(Inherited from System.Windows.Forms.Control)

BarDirection

Gets or sets the direction of the barcode.

BarHeight

Gets or sets the height of the bars in screen pixels.

BarNarrow

Gets or sets the width of the narrow bars in screen


pixels.

BarWide

Gets or sets the width of the wide bars in screen pixels.

BindingContext

(Inherited from System.Windows.Forms.Control)

Bottom

(Inherited from System.Windows.Forms.Control)

Bounds

(Inherited from System.Windows.Forms.Control)

CanFocus

(Inherited from System.Windows.Forms.Control)

CanSelect

(Inherited from System.Windows.Forms.Control)

Capture

(Inherited from System.Windows.Forms.Control)

CausesValidation

(Inherited from System.Windows.Forms.Control)

ClientRectangle

(Inherited from System.Windows.Forms.Control)

ClientSize

(Inherited from System.Windows.Forms.Control)

CodeType

Gets or sets the type of encoding to use when


generating the barcode image.

CompanyName

(Inherited from System.Windows.Forms.Control)

Container

(Inherited from System.ComponentModel.Component)

ContainsFocus

(Inherited from System.Windows.Forms.Control)

ContextMenu

(Inherited from System.Windows.Forms.Control)

ContextMenuStrip

(Inherited from System.Windows.Forms.Control)

Controls

(Inherited from System.Windows.Forms.Control)

Created

(Inherited from System.Windows.Forms.Control)

Cursor

(Inherited from System.Windows.Forms.Control)

DataBindings

(Inherited from System.Windows.Forms.Control)

DisplayRectangle

(Inherited from System.Windows.Forms.Control)

Disposing

(Inherited from System.Windows.Forms.Control)

Dock

(Inherited from System.Windows.Forms.Control)

Enabled

(Inherited from System.Windows.Forms.Control)

EncodingException

Gets the System.Exception that prevented the Text


from being encoded.

Focused

(Inherited from System.Windows.Forms.Control)

Font

Overridden. Gets or sets the Font used to display the


value of the Text property.

ForeColor

Overridden. Gets or sets the foreground color for the


control.

Handle

(Inherited from System.Windows.Forms.Control)

HasChildren

(Inherited from System.Windows.Forms.Control)

Height

(Inherited from System.Windows.Forms.Control)

Image

Gets an image of the barcode that represents the


value in the Text property, obtained using the
encoding specified by the CodeType property.

ImeMode

(Inherited from System.Windows.Forms.Control)

InvokeRequired

(Inherited from System.Windows.Forms.Control)

IsAccessible

(Inherited from System.Windows.Forms.Control)

IsDisposed

(Inherited from System.Windows.Forms.Control)

IsHandleCreated

(Inherited from System.Windows.Forms.Control)

IsMirrored

(Inherited from System.Windows.Forms.Control)

LayoutEngine

(Inherited from System.Windows.Forms.Control)

Left

(Inherited from System.Windows.Forms.Control)

Location

(Inherited from System.Windows.Forms.Control)

Margin

(Inherited from System.Windows.Forms.Control)

MaximumSize

(Inherited from System.Windows.Forms.Control)

MinimumSize

(Inherited from System.Windows.Forms.Control)

Name

(Inherited from System.Windows.Forms.Control)

Padding

(Inherited from System.Windows.Forms.Control)

Parent

(Inherited from System.Windows.Forms.Control)

PreferredSize

(Inherited from System.Windows.Forms.Control)

ProductName

(Inherited from System.Windows.Forms.Control)

ProductVersion

(Inherited from System.Windows.Forms.Control)

RecreatingHandle

(Inherited from System.Windows.Forms.Control)

Region

(Inherited from System.Windows.Forms.Control)

Right

(Inherited from System.Windows.Forms.Control)

RightToLeft

(Inherited from System.Windows.Forms.Control)

ShowText

Gets or sets whether the value of the Text property


should be displayed along with the barcode image.

Site

(Inherited from System.Windows.Forms.Control)

Size

(Inherited from System.Windows.Forms.Control)

SizeMode

Gets or sets how the barcode image is displayed


within the control.

TabIndex

(Inherited from System.Windows.Forms.Control)

TabStop

(Inherited from System.Windows.Forms.Control)

Tag

(Inherited from System.Windows.Forms.Control)

Text

Overridden. Gets or sets the value that is encoded as a


barcode image.

Top

(Inherited from System.Windows.Forms.Control)

TopLevelControl

(Inherited from System.Windows.Forms.Control)

UseWaitCursor

(Inherited from System.Windows.Forms.Control)

Visible

(Inherited from System.Windows.Forms.Control)

Width

(Inherited from System.Windows.Forms.Control)

Top

See Also
Reference
C1BarCode Class
C1.Win.C1BarCode Namespace

BackColor Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : BackColor Property

Gets or sets the background color for the control.

Syntax
Visual Basic (Declaration)
Public Overrides Property BackColor As System.Drawing.Color
C#
public override System.Drawing.Color BackColor {get; set;}

Remarks
The background color only applies to the control. The barcode image that is available through
the Image property always has a transparent background.

See Also
Reference

C1BarCode Class
C1BarCode Members

BarDirection Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : BarDirection
Property

Gets or sets the direction of the barcode.

Syntax
Visual Basic (Declaration)
Public Property BarDirection As BarDirectionEnum
C#
public BarDirectionEnum BarDirection {get; set;}

See Also
Reference
C1BarCode Class
C1BarCode Members

BarHeight Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : BarHeight Property

Gets or sets the height of the bars in screen pixels.

Syntax
Visual Basic (Declaration)
Public Property BarHeight As System.Integer
C#
public System.int BarHeight {get; set;}

See Also
Reference
C1BarCode Class
C1BarCode Members

BarNarrow Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : BarNarrow Property

Gets or sets the width of the narrow bars in screen pixels.

Syntax
Visual Basic (Declaration)
Public Property BarNarrow As System.Integer
C#
public System.int BarNarrow {get; set;}

Remarks
By default, narrow bars are one screen pixel wide (1/96") and wide bars are two pixels wide
(1/96"). You should never have to change these values, they are exposed only in case you need
to make adjustments for special barcode reader hardware.

See Also
Reference
C1BarCode Class
C1BarCode Members

BarWide Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : BarWide Property

Gets or sets the width of the wide bars in screen pixels.

Syntax
Visual Basic (Declaration)
Public Property BarWide As System.Integer
C#
public System.int BarWide {get; set;}

Remarks
By default, narrow bars are one screen pixel wide (1/96") and wide bars are two pixels wide
(1/96"). You should never have to change these values, they are exposed only in case you need
to make adjustments for special barcode reader hardware.

See Also
Reference
C1BarCode Class
C1BarCode Members

CodeType Property
Example
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : CodeType Property

Gets or sets the type of encoding to use when generating the barcode image.

Syntax
Visual Basic (Declaration)
Public Property CodeType As CodeTypeEnum
C#
public CodeTypeEnum CodeType {get; set;}

Remarks
The selected encoding is applied to the value stored in the Text property to generate the
barcode image displayed in the control. The barcode image is also available through the Image
property.

Example
This sample shows how to use the CodeType property to encode the value "123456" as a
Code39-encoded barcode.

C#

c1barcode1.CodeType = CodeTypeEnum.Code39;
c1barcode1.Text = "123456";
pictureBox1.Image = c1barcode1.Image;

See Also
Reference

C1BarCode Class
C1BarCode Members

EncodingException Property
Example
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : EncodingException
Property

Gets the System.Exception that prevented the Text from being encoded.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property EncodingException As System.Exception
C#
public System.Exception EncodingException {get;}

Remarks
Most encodings have limitations that determine what type of text it can represent. For example,
some are numeric-only and some require text of a specific length.
If the value of the Text property cannot be represented using the current CodeType, then no bar
code will be generated and the control will remain blank.
In this case, the EncodingException property returns details about the exception that
prevented the bar code from being generated.

Example
The code below sets the Text property and shows a message in case any errors were detected:

C#

c1BarCode1.Text = textBox1.Text;
label1.Text = c1BarCode1.EncodingException == null
? string.Empty
: c1BarCode1.EncodingException.Message;

See Also
Reference

C1BarCode Class
C1BarCode Members

Font Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : Font Property

Gets or sets the Font used to display the value of the Text property.

Syntax
Visual Basic (Declaration)
Public Overrides Property Font As System.Drawing.Font
C#
public override System.Drawing.Font Font {get; set;}

Remarks
If the ShowText property is set to true, then the value of the Text property is displayed centered
along the bottom of the barcode image using the given font.

See Also
Reference
C1BarCode Class
C1BarCode Members

ForeColor Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : ForeColor Property

Gets or sets the foreground color for the control.

Syntax
Visual Basic (Declaration)
Public Overrides Property ForeColor As System.Drawing.Color
C#
public override System.Drawing.Color ForeColor {get; set;}

Remarks
The foreground color applies to the control and also to the barcode image that is available
through the Image property.

See Also
Reference

C1BarCode Class
C1BarCode Members

Image Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : Image Property

Gets an image of the barcode that represents the value in the Text property, obtained using the
encoding specified by the CodeType property.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Image As System.Drawing.Image
C#
public System.Drawing.Image Image {get;}

Remarks
The Image property returns a System.Drawing.Imaging.Metafile that can be inserted in
reports and other documents. If the value stored in the Text property is invalid for the current
encoding, the image returned is blank.
Although the barcode image returned by the control is scalable, the default size is optimal for
common barcode readers. Keep in mind that if you stretch the image and make it very large or
very small, it may become unreadable to some readers.
The metafile image has a transparent background and therefore cannot be easily converted to a
solid-background bitmap. To obtain a System.Drawing.Bitmap image of the barcode, use the
GetImage(ImageFormat) method instead.

See Also
Reference
C1BarCode Class
C1BarCode Members

ShowText Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : ShowText Property

Gets or sets whether the value of the Text property should be displayed along with the barcode
image.

Syntax

Visual Basic (Declaration)


Public Property ShowText As System.Boolean
C#
public System.bool ShowText {get; set;}

Remarks
By default, the control will show only the barcode image. To include a textual representation of
the value in the Text property, set the ShowText property to True and set the Font property to
the Font to be used for the textual display.

See Also
Reference
C1BarCode Class
C1BarCode Members

SizeMode Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : SizeMode Property

Gets or sets how the barcode image is displayed within the control.

Syntax
Visual Basic (Declaration)
Public Property SizeMode As System.Windows.Forms.PictureBoxSizeMode
C#
public System.Windows.Forms.PictureBoxSizeMode SizeMode {get; set;}

Remarks
This property only affects how the barcode is displayed within the control. It has no effect on
the actual barcode image, as returned by the Image property.
In most applications, you will either center or left-align the barcode image within the control.
Although stretching the image is possible, it may make it unreadable for some barcode readers.

See Also
Reference

C1BarCode Class
C1BarCode Members

Text Property
Example
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1BarCode Class : Text Property

Gets or sets the value that is encoded as a barcode image.

Syntax
Visual Basic (Declaration)
Public Overrides Property Text As System.String
C#
public override System.string Text {get; set;}

Remarks
Some encodings support alpha-numeric values of any length. Others are limited to numeric
values or to a specific set of characters. See the CodeTypeEnum enumeration for details.
If you use characters that are invalid for the current encoding, the control will display a blank
image.

Example
This sample shows how to use the Text property to encode the value "123456" as a Code39encoded barcode.

C#

c1barcode1.CodeType = CodeTypeEnum.Code39;
c1barcode1.Text = "123456";
pictureBox1.Image = c1barcode1.Image;

See Also
Reference

C1BarCode Class
C1BarCode Members

C1QRCode
Members Example

C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1QRCode Class

Creates QR barcode representations of alphanumeric values.

Object Model

Syntax
Visual Basic (Declaration)
Public Class C1QRCode
Inherits System.Windows.Forms.Control
C#
public class C1QRCode : System.Windows.Forms.Control

Remarks
To use the C1QRCode control, simply set the Text property to the value you want to encode.
The control will show the QR image. If you want to include the QR image in a document, use
the Image property to retrieve an image of the barcode.
The QR (Quick Response) format is one of the most popular 2D barcode formats today, with
free readers available for virtually all smart phones.
The main reasons for the popularity of the QR format are its efficiency (it is very compact),
flexibility (you don't need special scanners to read it), and the fact that the original developer of
the format (the DENSO-WAVE company) made it an open and freely available standard
(ISO/IEC18004 and others).
For details on the QR format, please see: http://www.denso-wave.com/qrcode/qrstandarde.html and http://en.wikipedia.org/wiki/QR_code.

Example
This sample shows how to use the Text property to encode the value "123456" as a QR barcode.

C#

c1qr1.Text = "Hello QR!";


pictureBox1.Image = c1qr1.Image;

Inheritance Hierarchy

System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
C1.Win.C1BarCode.C1QRCode

See Also
Reference
C1QRCode Members
C1.Win.C1BarCode Namespace

Overview
Members Example
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1QRCode Class

Creates QR barcode representations of alphanumeric values.

Object Model

Syntax
Visual Basic (Declaration)
Public Class C1QRCode
Inherits System.Windows.Forms.Control
C#
public class C1QRCode : System.Windows.Forms.Control

Remarks
To use the C1QRCode control, simply set the Text property to the value you want to encode.
The control will show the QR image. If you want to include the QR image in a document, use
the Image property to retrieve an image of the barcode.
The QR (Quick Response) format is one of the most popular 2D barcode formats today, with
free readers available for virtually all smart phones.
The main reasons for the popularity of the QR format are its efficiency (it is very compact),
flexibility (you don't need special scanners to read it), and the fact that the original developer of

the format (the DENSO-WAVE company) made it an open and freely available standard
(ISO/IEC18004 and others).
For details on the QR format, please see: http://www.denso-wave.com/qrcode/qrstandarde.html and http://en.wikipedia.org/wiki/QR_code.

Example
This sample shows how to use the Text property to encode the value "123456" as a QR barcode.

C#

c1qr1.Text = "Hello QR!";


pictureBox1.Image = c1qr1.Image;

Inheritance Hierarchy
System.Object
System.MarshalByRefObject

System.ComponentModel.Component
System.Windows.Forms.Control
C1.Win.C1BarCode.C1QRCode

See Also
Reference
C1QRCode Members
C1.Win.C1BarCode Namespace

Members
Properties Methods Events
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1QRCode Class

The following tables list the members exposed by C1QRCode.

Public Constructors
Name

Description

C1QRCode Constructor Creates a new instance of the C1QRCode control.


Top

Public Properties

Name

Description

AccessibilityObject

(Inherited from System.Windows.Forms.Control)

AccessibleDefaultActionDescription (Inherited from System.Windows.Forms.Control)


AccessibleDescription

(Inherited from System.Windows.Forms.Control)

AccessibleName

(Inherited from System.Windows.Forms.Control)

AccessibleRole

(Inherited from System.Windows.Forms.Control)

AllowDrop

(Inherited from System.Windows.Forms.Control)

Anchor

(Inherited from System.Windows.Forms.Control)

AutoScrollOffset

(Inherited from System.Windows.Forms.Control)

BackColor

Overridden. Gets or sets the background color for the


control.

BackgroundImage

(Inherited from System.Windows.Forms.Control)

BackgroundImageLayout

(Inherited from System.Windows.Forms.Control)

BindingContext

(Inherited from System.Windows.Forms.Control)

Bottom

(Inherited from System.Windows.Forms.Control)

Bounds

(Inherited from System.Windows.Forms.Control)

CanFocus

(Inherited from System.Windows.Forms.Control)

CanSelect

(Inherited from System.Windows.Forms.Control)

Capture

(Inherited from System.Windows.Forms.Control)

CausesValidation

(Inherited from System.Windows.Forms.Control)

ClientRectangle

(Inherited from System.Windows.Forms.Control)

ClientSize

(Inherited from System.Windows.Forms.Control)

CodeVersion

Gets or sets the "version" of QR code to generate.

CompanyName

(Inherited from System.Windows.Forms.Control)

Container

(Inherited from System.ComponentModel.Component)

ContainsFocus

(Inherited from System.Windows.Forms.Control)

ContextMenu

(Inherited from System.Windows.Forms.Control)

ContextMenuStrip

(Inherited from System.Windows.Forms.Control)

Controls

(Inherited from System.Windows.Forms.Control)

Created

(Inherited from System.Windows.Forms.Control)

Cursor

(Inherited from System.Windows.Forms.Control)

DataBindings

(Inherited from System.Windows.Forms.Control)

DisplayRectangle

(Inherited from System.Windows.Forms.Control)

Disposing

(Inherited from System.Windows.Forms.Control)

Dock

(Inherited from System.Windows.Forms.Control)

Enabled

(Inherited from System.Windows.Forms.Control)

Encoding

Gets or sets the Encoding used to translate the


content in the Text property into binary values to be
encoded in the QR code.

EncodingException

Gets the System.Exception that prevented the Text


from being encoded.

ErrorCorrectionLevel

Gets or sets the error correction level used to create


the QR code.

Focused

(Inherited from System.Windows.Forms.Control)

ForeColor

Overridden. Gets or sets the foreground color for the


control.

Handle

(Inherited from System.Windows.Forms.Control)

HasChildren

(Inherited from System.Windows.Forms.Control)

Height

(Inherited from System.Windows.Forms.Control)

Image

Gets an image of the barcode that represents the


value in the Text property.

ImeMode

(Inherited from System.Windows.Forms.Control)

InvokeRequired

(Inherited from System.Windows.Forms.Control)

IsAccessible

(Inherited from System.Windows.Forms.Control)

IsDisposed

(Inherited from System.Windows.Forms.Control)

IsHandleCreated

(Inherited from System.Windows.Forms.Control)

IsMirrored

(Inherited from System.Windows.Forms.Control)

LayoutEngine

(Inherited from System.Windows.Forms.Control)

Left

(Inherited from System.Windows.Forms.Control)

Location

(Inherited from System.Windows.Forms.Control)

Margin

(Inherited from System.Windows.Forms.Control)

MaximumSize

(Inherited from System.Windows.Forms.Control)

MinimumSize

(Inherited from System.Windows.Forms.Control)

Name

(Inherited from System.Windows.Forms.Control)

Padding

(Inherited from System.Windows.Forms.Control)

Parent

(Inherited from System.Windows.Forms.Control)

PreferredSize

(Inherited from System.Windows.Forms.Control)

ProductName

(Inherited from System.Windows.Forms.Control)

ProductVersion

(Inherited from System.Windows.Forms.Control)

RecreatingHandle

(Inherited from System.Windows.Forms.Control)

Region

(Inherited from System.Windows.Forms.Control)

Right

(Inherited from System.Windows.Forms.Control)

RightToLeft

(Inherited from System.Windows.Forms.Control)

Site

(Inherited from System.Windows.Forms.Control)

Size

(Inherited from System.Windows.Forms.Control)

SizeMode

Gets or sets how the barcode image is displayed


within the control.

SymbolSize

Gets or sets the size, in pixels, of the symbols used to


build the QR image.

TabIndex

(Inherited from System.Windows.Forms.Control)

TabStop

(Inherited from System.Windows.Forms.Control)

Tag

(Inherited from System.Windows.Forms.Control)

Text

Overridden. Gets or sets the value that is encoded as a


barcode image.

Top

(Inherited from System.Windows.Forms.Control)

TopLevelControl

(Inherited from System.Windows.Forms.Control)

UseWaitCursor

(Inherited from System.Windows.Forms.Control)

Visible

(Inherited from System.Windows.Forms.Control)

Width

(Inherited from System.Windows.Forms.Control)

Top

Public Methods
Name

Description

BeginInvoke

Overloaded. (Inherited from System.Windows.Forms.Control)

BringToFront

(Inherited from System.Windows.Forms.Control)

Contains

(Inherited from System.Windows.Forms.Control)

CreateControl

(Inherited from System.Windows.Forms.Control)

CreateGraphics

(Inherited from System.Windows.Forms.Control)

CreateObjRef

(Inherited from System.MarshalByRefObject)

Dispose

(Inherited from System.ComponentModel.Component)

DoDragDrop

(Inherited from System.Windows.Forms.Control)

DrawToBitmap

(Inherited from System.Windows.Forms.Control)

EndInvoke

(Inherited from System.Windows.Forms.Control)

FindForm

(Inherited from System.Windows.Forms.Control)

Focus

(Inherited from System.Windows.Forms.Control)

GetChildAtPoint

Overloaded. (Inherited from System.Windows.Forms.Control)

GetContainerControl

(Inherited from System.Windows.Forms.Control)

GetImage

Overloaded. Gets an image of the QR code that represents the


value in the Text property.

GetLifetimeService

(Inherited from System.MarshalByRefObject)

GetNextControl

(Inherited from System.Windows.Forms.Control)

GetPreferredSize

(Inherited from System.Windows.Forms.Control)

Hide

(Inherited from System.Windows.Forms.Control)

InitializeLifetimeService

(Inherited from System.MarshalByRefObject)

Invalidate

Overloaded. (Inherited from System.Windows.Forms.Control)

Invoke

Overloaded. (Inherited from System.Windows.Forms.Control)

PerformLayout

Overloaded. (Inherited from System.Windows.Forms.Control)

PointToClient

(Inherited from System.Windows.Forms.Control)

PointToScreen

(Inherited from System.Windows.Forms.Control)

PreProcessControlMessage (Inherited from System.Windows.Forms.Control)


PreProcessMessage

(Inherited from System.Windows.Forms.Control)

RectangleToClient

(Inherited from System.Windows.Forms.Control)

RectangleToScreen

(Inherited from System.Windows.Forms.Control)

Refresh

(Inherited from System.Windows.Forms.Control)

ResetText

(Inherited from System.Windows.Forms.Control)

ResumeLayout

Overloaded. (Inherited from System.Windows.Forms.Control)

Scale

(Inherited from System.Windows.Forms.Control)

Select

(Inherited from System.Windows.Forms.Control)

SelectNextControl

(Inherited from System.Windows.Forms.Control)

SendToBack

(Inherited from System.Windows.Forms.Control)

SetBounds

Overloaded. (Inherited from System.Windows.Forms.Control)

Show

(Inherited from System.Windows.Forms.Control)

SuspendLayout

(Inherited from System.Windows.Forms.Control)

ToString

(Inherited from System.ComponentModel.Component)

Update

(Inherited from System.Windows.Forms.Control)

Top

Public Events
Name

Description

BackColorChanged

(Inherited from System.Windows.Forms.Control)

BackgroundImageChanged

(Inherited from System.Windows.Forms.Control)

BackgroundImageLayoutChanged (Inherited from System.Windows.Forms.Control)


BindingContextChanged

(Inherited from System.Windows.Forms.Control)

CausesValidationChanged

(Inherited from System.Windows.Forms.Control)

ChangeUICues

(Inherited from System.Windows.Forms.Control)

Click

(Inherited from System.Windows.Forms.Control)

ClientSizeChanged

(Inherited from System.Windows.Forms.Control)

ContextMenuChanged

(Inherited from System.Windows.Forms.Control)

ContextMenuStripChanged

(Inherited from System.Windows.Forms.Control)

ControlAdded

(Inherited from System.Windows.Forms.Control)

ControlRemoved

(Inherited from System.Windows.Forms.Control)

CursorChanged

(Inherited from System.Windows.Forms.Control)

Disposed

(Inherited from System.ComponentModel.Component)

DockChanged

(Inherited from System.Windows.Forms.Control)

DoubleClick

(Inherited from System.Windows.Forms.Control)

DragDrop

(Inherited from System.Windows.Forms.Control)

DragEnter

(Inherited from System.Windows.Forms.Control)

DragLeave

(Inherited from System.Windows.Forms.Control)

DragOver

(Inherited from System.Windows.Forms.Control)

EnabledChanged

(Inherited from System.Windows.Forms.Control)

Enter

(Inherited from System.Windows.Forms.Control)

FontChanged

(Inherited from System.Windows.Forms.Control)

ForeColorChanged

(Inherited from System.Windows.Forms.Control)

GiveFeedback

(Inherited from System.Windows.Forms.Control)

GotFocus

(Inherited from System.Windows.Forms.Control)

HandleCreated

(Inherited from System.Windows.Forms.Control)

HandleDestroyed

(Inherited from System.Windows.Forms.Control)

HelpRequested

(Inherited from System.Windows.Forms.Control)

ImeModeChanged

(Inherited from System.Windows.Forms.Control)

Invalidated

(Inherited from System.Windows.Forms.Control)

KeyDown

(Inherited from System.Windows.Forms.Control)

KeyPress

(Inherited from System.Windows.Forms.Control)

KeyUp

(Inherited from System.Windows.Forms.Control)

Layout

(Inherited from System.Windows.Forms.Control)

Leave

(Inherited from System.Windows.Forms.Control)

LocationChanged

(Inherited from System.Windows.Forms.Control)

LostFocus

(Inherited from System.Windows.Forms.Control)

MarginChanged

(Inherited from System.Windows.Forms.Control)

MouseCaptureChanged

(Inherited from System.Windows.Forms.Control)

MouseClick

(Inherited from System.Windows.Forms.Control)

MouseDoubleClick

(Inherited from System.Windows.Forms.Control)

MouseDown

(Inherited from System.Windows.Forms.Control)

MouseEnter

(Inherited from System.Windows.Forms.Control)

MouseHover

(Inherited from System.Windows.Forms.Control)

MouseLeave

(Inherited from System.Windows.Forms.Control)

MouseMove

(Inherited from System.Windows.Forms.Control)

MouseUp

(Inherited from System.Windows.Forms.Control)

MouseWheel

(Inherited from System.Windows.Forms.Control)

Move

(Inherited from System.Windows.Forms.Control)

PaddingChanged

(Inherited from System.Windows.Forms.Control)

Paint

(Inherited from System.Windows.Forms.Control)

ParentChanged

(Inherited from System.Windows.Forms.Control)

PreviewKeyDown

(Inherited from System.Windows.Forms.Control)

QueryAccessibilityHelp

(Inherited from System.Windows.Forms.Control)

QueryContinueDrag

(Inherited from System.Windows.Forms.Control)

RegionChanged

(Inherited from System.Windows.Forms.Control)

Resize

(Inherited from System.Windows.Forms.Control)

RightToLeftChanged

(Inherited from System.Windows.Forms.Control)

SizeChanged

(Inherited from System.Windows.Forms.Control)

StyleChanged

(Inherited from System.Windows.Forms.Control)

SystemColorsChanged

(Inherited from System.Windows.Forms.Control)

TabIndexChanged

(Inherited from System.Windows.Forms.Control)

TabStopChanged

(Inherited from System.Windows.Forms.Control)

TextChanged

(Inherited from System.Windows.Forms.Control)

Validated

(Inherited from System.Windows.Forms.Control)

Validating

(Inherited from System.Windows.Forms.Control)

VisibleChanged

(Inherited from System.Windows.Forms.Control)

Top

See Also
Reference
C1QRCode Class
C1.Win.C1BarCode Namespace

C1QRCode Constructor
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : C1QRCode
Constructor

Creates a new instance of the C1QRCode control.

Syntax
Visual Basic (Declaration)
Public Function New()
C#
public C1QRCode()

See Also
Reference
C1QRCode Class
C1QRCode Members

Methods
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1QRCode Class

For a list of all members of this type, see C1QRCode members.

Public Methods
Name

Description

BeginInvoke

Overloaded. (Inherited from System.Windows.Forms.Control)

BringToFront

(Inherited from System.Windows.Forms.Control)

Contains

(Inherited from System.Windows.Forms.Control)

CreateControl

(Inherited from System.Windows.Forms.Control)

CreateGraphics

(Inherited from System.Windows.Forms.Control)

CreateObjRef

(Inherited from System.MarshalByRefObject)

Dispose

(Inherited from System.ComponentModel.Component)

DoDragDrop

(Inherited from System.Windows.Forms.Control)

DrawToBitmap

(Inherited from System.Windows.Forms.Control)

EndInvoke

(Inherited from System.Windows.Forms.Control)

FindForm

(Inherited from System.Windows.Forms.Control)

Focus

(Inherited from System.Windows.Forms.Control)

GetChildAtPoint

Overloaded. (Inherited from System.Windows.Forms.Control)

GetContainerControl

(Inherited from System.Windows.Forms.Control)

GetImage

Overloaded. Gets an image of the QR code that represents the


value in the Text property.

GetLifetimeService

(Inherited from System.MarshalByRefObject)

GetNextControl

(Inherited from System.Windows.Forms.Control)

GetPreferredSize

(Inherited from System.Windows.Forms.Control)

Hide

(Inherited from System.Windows.Forms.Control)

InitializeLifetimeService

(Inherited from System.MarshalByRefObject)

Invalidate

Overloaded. (Inherited from System.Windows.Forms.Control)

Invoke

Overloaded. (Inherited from System.Windows.Forms.Control)

PerformLayout

Overloaded. (Inherited from System.Windows.Forms.Control)

PointToClient

(Inherited from System.Windows.Forms.Control)

PointToScreen

(Inherited from System.Windows.Forms.Control)

PreProcessControlMessage (Inherited from System.Windows.Forms.Control)


PreProcessMessage

(Inherited from System.Windows.Forms.Control)

RectangleToClient

(Inherited from System.Windows.Forms.Control)

RectangleToScreen

(Inherited from System.Windows.Forms.Control)

Refresh

(Inherited from System.Windows.Forms.Control)

ResetText

(Inherited from System.Windows.Forms.Control)

ResumeLayout

Overloaded. (Inherited from System.Windows.Forms.Control)

Scale

(Inherited from System.Windows.Forms.Control)

Select

(Inherited from System.Windows.Forms.Control)

SelectNextControl

(Inherited from System.Windows.Forms.Control)

SendToBack

(Inherited from System.Windows.Forms.Control)

SetBounds

Overloaded. (Inherited from System.Windows.Forms.Control)

Show

(Inherited from System.Windows.Forms.Control)

SuspendLayout

(Inherited from System.Windows.Forms.Control)

ToString

(Inherited from System.ComponentModel.Component)

Update

(Inherited from System.Windows.Forms.Control)

Top

See Also
Reference
C1QRCode Class
C1.Win.C1BarCode Namespace

GetImage Method
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : GetImage Method

Gets an image of the QR code that represents the value in the Text property.

Overload List
Overload

Description

GetImage(ImageFormat)

Gets an image of the QR code that represents the value in


the Text property.

GetImage(ImageFormat,Int32,Int32) Gets an image of the QR code that represents the value in


the Text property.

See Also
Reference

C1QRCode Class
C1QRCode Members

GetImage(ImageFormat) Method
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class > GetImage Method :
GetImage(ImageFormat) Method

An System.Drawing.Imaging.ImageFormat value that specifies the type of image to be


created.
Gets an image of the QR code that represents the value in the Text property.

Syntax
Visual Basic (Declaration)
Public Overloads Function GetImage( _
ByVal format As System.Drawing.Imaging.ImageFormat _
) As System.Drawing.Image
C#
public System.Drawing.Image GetImage(
System.Drawing.Imaging.ImageFormat format
)

Parameters
format
An System.Drawing.Imaging.ImageFormat value that specifies the type of image to
be created.

Return Value
An image of the barcode with the specified format.

Remarks
The Image property can also be used to obtain an image of the barcode. However, it
always returns a System.Drawing.Imaging.Metafile image of a pre-set size and with a
transparent background. This method returns solid-background bitmaps.

See Also
Reference

C1QRCode Class
C1QRCode Members
Overload List

GetImage(ImageFormat,Int32,Int32) Method
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class > GetImage Method :
GetImage(ImageFormat,Int32,Int32) Method

An System.Drawing.Imaging.ImageFormat value that specifies the type of image to be


created.
The width of the image, in pixels.
The height of the image, in pixels.
Gets an image of the QR code that represents the value in the Text property.

Syntax
Visual Basic (Declaration)
Public Overloads Function GetImage( _
ByVal format As System.Drawing.Imaging.ImageFormat, _
ByVal width As System.Integer, _
ByVal height As System.Integer _
) As System.Drawing.Image
C#
public System.Drawing.Image GetImage(
System.Drawing.Imaging.ImageFormat format,
System.int width,
System.int height
)

Parameters
format
An System.Drawing.Imaging.ImageFormat value that specifies the type of image to
be created.
width
The width of the image, in pixels.
height
The height of the image, in pixels.

Return Value
An image of the barcode with the specified format and dimensions.

Remarks
The Image property can also be used to obtain an image of the barcode.
However, it always returns a System.Drawing.Imaging.Metafile image of a
pre-set size and with a transparent background. This method returns solidbackground bitmaps.

See Also
Reference
C1QRCode Class
C1QRCode Members
Overload List

Properties
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1QRCode Class

For a list of all members of this type, see C1QRCode members.

Public Properties
Name

Description

AccessibilityObject

(Inherited from System.Windows.Forms.Control)

AccessibleDefaultActionDescription (Inherited from System.Windows.Forms.Control)


AccessibleDescription

(Inherited from System.Windows.Forms.Control)

AccessibleName

(Inherited from System.Windows.Forms.Control)

AccessibleRole

(Inherited from System.Windows.Forms.Control)

AllowDrop

(Inherited from System.Windows.Forms.Control)

Anchor

(Inherited from System.Windows.Forms.Control)

AutoScrollOffset

(Inherited from System.Windows.Forms.Control)

BackColor

Overridden. Gets or sets the background color for the


control.

BackgroundImage

(Inherited from System.Windows.Forms.Control)

BackgroundImageLayout

(Inherited from System.Windows.Forms.Control)

BindingContext

(Inherited from System.Windows.Forms.Control)

Bottom

(Inherited from System.Windows.Forms.Control)

Bounds

(Inherited from System.Windows.Forms.Control)

CanFocus

(Inherited from System.Windows.Forms.Control)

CanSelect

(Inherited from System.Windows.Forms.Control)

Capture

(Inherited from System.Windows.Forms.Control)

CausesValidation

(Inherited from System.Windows.Forms.Control)

ClientRectangle

(Inherited from System.Windows.Forms.Control)

ClientSize

(Inherited from System.Windows.Forms.Control)

CodeVersion

Gets or sets the "version" of QR code to generate.

CompanyName

(Inherited from System.Windows.Forms.Control)

Container

(Inherited from System.ComponentModel.Component)

ContainsFocus

(Inherited from System.Windows.Forms.Control)

ContextMenu

(Inherited from System.Windows.Forms.Control)

ContextMenuStrip

(Inherited from System.Windows.Forms.Control)

Controls

(Inherited from System.Windows.Forms.Control)

Created

(Inherited from System.Windows.Forms.Control)

Cursor

(Inherited from System.Windows.Forms.Control)

DataBindings

(Inherited from System.Windows.Forms.Control)

DisplayRectangle

(Inherited from System.Windows.Forms.Control)

Disposing

(Inherited from System.Windows.Forms.Control)

Dock

(Inherited from System.Windows.Forms.Control)

Enabled

(Inherited from System.Windows.Forms.Control)

Encoding

Gets or sets the Encoding used to translate the


content in the Text property into binary values to be
encoded in the QR code.

EncodingException

Gets the System.Exception that prevented the Text


from being encoded.

ErrorCorrectionLevel

Gets or sets the error correction level used to create


the QR code.

Focused

(Inherited from System.Windows.Forms.Control)

ForeColor

Overridden. Gets or sets the foreground color for the


control.

Handle

(Inherited from System.Windows.Forms.Control)

HasChildren

(Inherited from System.Windows.Forms.Control)

Height

(Inherited from System.Windows.Forms.Control)

Image

Gets an image of the barcode that represents the


value in the Text property.

ImeMode

(Inherited from System.Windows.Forms.Control)

InvokeRequired

(Inherited from System.Windows.Forms.Control)

IsAccessible

(Inherited from System.Windows.Forms.Control)

IsDisposed

(Inherited from System.Windows.Forms.Control)

IsHandleCreated

(Inherited from System.Windows.Forms.Control)

IsMirrored

(Inherited from System.Windows.Forms.Control)

LayoutEngine

(Inherited from System.Windows.Forms.Control)

Left

(Inherited from System.Windows.Forms.Control)

Location

(Inherited from System.Windows.Forms.Control)

Margin

(Inherited from System.Windows.Forms.Control)

MaximumSize

(Inherited from System.Windows.Forms.Control)

MinimumSize

(Inherited from System.Windows.Forms.Control)

Name

(Inherited from System.Windows.Forms.Control)

Padding

(Inherited from System.Windows.Forms.Control)

Parent

(Inherited from System.Windows.Forms.Control)

PreferredSize

(Inherited from System.Windows.Forms.Control)

ProductName

(Inherited from System.Windows.Forms.Control)

ProductVersion

(Inherited from System.Windows.Forms.Control)

RecreatingHandle

(Inherited from System.Windows.Forms.Control)

Region

(Inherited from System.Windows.Forms.Control)

Right

(Inherited from System.Windows.Forms.Control)

RightToLeft

(Inherited from System.Windows.Forms.Control)

Site

(Inherited from System.Windows.Forms.Control)

Size

(Inherited from System.Windows.Forms.Control)

SizeMode

Gets or sets how the barcode image is displayed


within the control.

SymbolSize

Gets or sets the size, in pixels, of the symbols used to


build the QR image.

TabIndex

(Inherited from System.Windows.Forms.Control)

TabStop

(Inherited from System.Windows.Forms.Control)

Tag

(Inherited from System.Windows.Forms.Control)

Text

Overridden. Gets or sets the value that is encoded as a


barcode image.

Top

(Inherited from System.Windows.Forms.Control)

TopLevelControl

(Inherited from System.Windows.Forms.Control)

UseWaitCursor

(Inherited from System.Windows.Forms.Control)

Visible

(Inherited from System.Windows.Forms.Control)

Width

(Inherited from System.Windows.Forms.Control)

Top

See Also
Reference

C1QRCode Class
C1.Win.C1BarCode Namespace

BackColor Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : BackColor Property

Gets or sets the background color for the control.

Syntax
Visual Basic (Declaration)
Public Overrides Property BackColor As System.Drawing.Color
C#
public override System.Drawing.Color BackColor {get; set;}

Remarks
The background color only applies to the control. The barcode image that is available through
the Image property always has a transparent background.

See Also
Reference
C1QRCode Class
C1QRCode Members

CodeVersion Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : CodeVersion
Property

Gets or sets the "version" of QR code to generate.

Syntax
Visual Basic (Declaration)
Public Property CodeVersion As System.Integer
C#
public System.int CodeVersion {get; set;}

Remarks

The QR specification includes 40 "versions" of QR codes. Higher versions consume more space
and are able to encode more information.
The C1QRCode control can generate QR codes versions one through ten only, which allow
encoding up to 652 digits, or 395 alphanumeric characters, or 271 bytes.
Set the CodeVersion property to zero (the default value) to automatically use the most compact
version able to render the content specified in the Text property.

See Also
Reference
C1QRCode Class
C1QRCode Members

Encoding Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : Encoding Property

Gets or sets the Encoding used to translate the content in the Text property into binary values
to be encoded in the QR code.

Syntax
Visual Basic (Declaration)
Public Property Encoding As Encoding
C#
public Encoding Encoding {get; set;}

Remarks
More flexible encodings have lower capacity. The C1QRCode control can encode up to 652
digits, or 395 alphanumeric characters, or 271 bytes.
The default value for this property is Encoding.Automatic, which causes the control to
automatically select the most compact encoding that can be used based on the content
specified in the Text property.

See Also
Reference
C1QRCode Class
C1QRCode Members

EncodingException Property
Example
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : EncodingException
Property

Gets the System.Exception that prevented the Text from being encoded.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property EncodingException As System.Exception
C#
public System.Exception EncodingException {get;}

Remarks
The C1QRCode control can be used to encode up to 652 digits, or 395 alphanumeric characters
(uppercase only), or 271 bytes.
If these limits are exceeded, or if any of the control properties is set to values that prevent the
content of the Text property from being encoded, the control remains blank, and the
EncodingException property contains details that explain why the code could not be generated.

Example
The code below sets the Text property and shows a message in case any errors are detected:

C#

c1QRCode1.Text = textBox1.Text;
label1.Text = c1QRCode1.EncodingException == null
? string.Empty
: c1QRCode1.EncodingException.Message;

See Also
Reference

C1QRCode Class
C1QRCode Members

ErrorCorrectionLevel Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : ErrorCorrectionLevel
Property

Gets or sets the error correction level used to create the QR code.

Syntax
Visual Basic (Declaration)
Public Property ErrorCorrectionLevel As ErrorCorrectionLevel
C#
public ErrorCorrectionLevel ErrorCorrectionLevel {get; set;}

Remarks
Higher levels of error correction add more redundant information to the QR code, making it
more resistant to damage. Higher levels of error correction also reduce the amount of data that
can be encoded in a given area.
The default value for this property is the lowest level, which produces the most compact QR
codes.

See Also
Reference
C1QRCode Class
C1QRCode Members

ForeColor Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : ForeColor Property

Gets or sets the foreground color for the control.

Syntax
Visual Basic (Declaration)
Public Overrides Property ForeColor As System.Drawing.Color
C#
public override System.Drawing.Color ForeColor {get; set;}

Remarks
The foreground color applies to the control and also to the barcode image that is available
through the Image property.

See Also

Reference
C1QRCode Class
C1QRCode Members

Image Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : Image Property

Gets an image of the barcode that represents the value in the Text property.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Image As System.Drawing.Image
C#
public System.Drawing.Image Image {get;}

Remarks
The Image property returns a System.Drawing.Imaging.Metafile that can be inserted in
reports and other documents. If the value stored in the Text property is invalid for the current
encoding, the image returned is blank.
Although the barcode image returned by the control is scalable, the default size is optimal for
common barcode readers. Keep in mind that if you stretch the image and make it very large or
very small, it may become unreadable to some readers.
The metafile image has a transparent background and therefore cannot be easily converted to a
solid-background bitmap. To obtain a System.Drawing.Bitmap image of the barcode, use the
GetImage(ImageFormat) method instead.

See Also
Reference
C1QRCode Class
C1QRCode Members

SizeMode Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : SizeMode Property

Gets or sets how the barcode image is displayed within the control.

Syntax

Visual Basic (Declaration)


Public Property SizeMode As System.Windows.Forms.PictureBoxSizeMode
C#
public System.Windows.Forms.PictureBoxSizeMode SizeMode {get; set;}

Remarks
This property only affects how the barcode is displayed within the control. It has no effect on
the actual barcode image, as returned by the Image property.
In most applications, you will either center or left-align the barcode image within the control.
Although stretching the image is possible, it may make it unreadable for some barcode readers.

See Also
Reference
C1QRCode Class
C1QRCode Members

SymbolSize Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : SymbolSize Property

Gets or sets the size, in pixels, of the symbols used to build the QR image.

Syntax
Visual Basic (Declaration)
Public Property SymbolSize As System.Integer
C#
public System.int SymbolSize {get; set;}

Remarks
Larger values will result in larger images which consume more space but may be easier to for
some scanners to read.
The default symbol size is three pixels, which usually represents a good compromise between
size and readability.
This property must be set to values between 2 and 10.

See Also
Reference
C1QRCode Class
C1QRCode Members

Text Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > C1QRCode Class : Text Property

Gets or sets the value that is encoded as a barcode image.

Syntax
Visual Basic (Declaration)
Public Overrides Property Text As System.String
C#
public override System.string Text {get; set;}

See Also
Reference
C1QRCode Class
C1QRCode Members

Strings
Members
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : Strings Class

Static class containing UI strings used by the designer.

Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit NotInheritable Class Strings

C#
public static class Strings

Inheritance Hierarchy
System.Object
C1.Win.C1BarCode.Strings

See Also
Reference
Strings Members
C1.Win.C1BarCode Namespace

Overview
Members
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : Strings Class

Static class containing UI strings used by the designer.

Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit NotInheritable Class Strings
C#
public static class Strings

Inheritance Hierarchy
System.Object
C1.Win.C1BarCode.Strings

See Also
Reference

Strings Members
C1.Win.C1BarCode Namespace

Members
Properties
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : Strings Class

The following tables list the members exposed by Strings.

Public Properties
Name

Description

ResourceManager
UICulture
Top

See Also
Reference
Strings Class
C1.Win.C1BarCode Namespace

Properties
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : Strings Class

For a list of all members of this type, see Strings members.

Public Properties
Name
ResourceManager
UICulture
Top

See Also
Reference

Description

Strings Class
C1.Win.C1BarCode Namespace

ResourceManager Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > Strings Class : ResourceManager
Property

Syntax
Visual Basic (Declaration)
Public Shared Property ResourceManager As System.Resources.ResourceManager
C#
public static System.Resources.ResourceManager ResourceManager {get; set;}

See Also
Reference
Strings Class
Strings Members

UICulture Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > Strings Class : UICulture Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property UICulture As System.Globalization.CultureInfo
C#
public static System.Globalization.CultureInfo UICulture {get;}

See Also
Reference
Strings Class
Strings Members

Strings.Errors
Members

C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : Strings.Errors Class

Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit NotInheritable Class Strings.Errors
C#
public static class Strings.Errors

Inheritance Hierarchy
System.Object
C1.Win.C1BarCode.Strings.Errors

See Also
Reference
Strings.Errors Members
C1.Win.C1BarCode Namespace

Overview
Members
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : Strings.Errors Class

Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit NotInheritable Class Strings.Errors
C#
public static class Strings.Errors

Inheritance Hierarchy
System.Object
C1.Win.C1BarCode.Strings.Errors

See Also
Reference
Strings.Errors Members
C1.Win.C1BarCode Namespace

Members
Properties
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : Strings.Errors Class

The following tables list the members exposed by Strings.Errors.

Public Properties
Name

Description

BarHeightMustBePositive
BarNarrowMustBePositive
BarWideMustBePositive
InvalidCodeVersion
InvalidSymbolSize
Top

See Also
Reference
Strings.Errors Class
C1.Win.C1BarCode Namespace

Properties
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : Strings.Errors Class

For a list of all members of this type, see Strings.Errors members.

Public Properties
Name

Description

BarHeightMustBePositive
BarNarrowMustBePositive
BarWideMustBePositive
InvalidCodeVersion
InvalidSymbolSize
Top

See Also
Reference
Strings.Errors Class
C1.Win.C1BarCode Namespace

BarHeightMustBePositive Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > Strings.Errors Class :
BarHeightMustBePositive Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property BarHeightMustBePositive As System.String
C#
public static System.string BarHeightMustBePositive {get;}

See Also
Reference
Strings.Errors Class
Strings.Errors Members

BarNarrowMustBePositive Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > Strings.Errors Class :
BarNarrowMustBePositive Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property BarNarrowMustBePositive As System.String
C#
public static System.string BarNarrowMustBePositive {get;}

See Also
Reference
Strings.Errors Class
Strings.Errors Members

BarWideMustBePositive Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > Strings.Errors Class :
BarWideMustBePositive Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property BarWideMustBePositive As System.String
C#
public static System.string BarWideMustBePositive {get;}

See Also
Reference
Strings.Errors Class
Strings.Errors Members

InvalidCodeVersion Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > Strings.Errors Class :
InvalidCodeVersion Property

Syntax

Visual Basic (Declaration)


Public Shared ReadOnly Property InvalidCodeVersion As System.String
C#
public static System.string InvalidCodeVersion {get;}

See Also
Reference
Strings.Errors Class
Strings.Errors Members

InvalidSymbolSize Property
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace > Strings.Errors Class : InvalidSymbolSize
Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property InvalidSymbolSize As System.String
C#
public static System.string InvalidSymbolSize {get;}

See Also
Reference
Strings.Errors Class
Strings.Errors Members

Enumerations
BarDirectionEnum
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : BarDirectionEnum Enumeration

Specifies the direction of the barcode

Syntax
Visual Basic (Declaration)

Public Enum BarDirectionEnum


Inherits System.Enum
C#
public enum BarDirectionEnum : System.Enum

Members
Member

Description

Down

The barcode is rendered from the top down.

Normal

The barcode is rendered in the horizontal direction.

Up

The barcode is rendered from the bottom up.

Inheritance Hierarchy
System.Object
System.ValueType
System.Enum
C1.Win.C1BarCode.BarDirectionEnum

See Also
Reference
C1.Win.C1BarCode Namespace

CodeTypeEnum
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : CodeTypeEnum Enumeration

Specifies the type of barcode to be generated by the C1BarCode control.

Syntax
Visual Basic (Declaration)
Public Enum CodeTypeEnum
Inherits System.Enum
C#
public enum CodeTypeEnum : System.Enum

Members
Member

Description

Codabar

Codabar may encode 16 different characters (0 through 9 plus -$:/.+), plus


an additional 4 start/stop characters (A through D). Codabar is used by
some US blood banks, photo labs, and on FedEx air bills.

Code128

Code 128 is a very high density alpha-numeric bar code. It will use the least
amount of space of any current 1-D symbology for symbols with 6
characters or more.

Code39

Code 39 is an alpha-numeric encoding also known as 3 of 9 and LOGMARS.


This was the first alphanumeric symbology developed, and is one of the
most widely used encodings.

Code93

Code 93 is an alpha-numeric encoding that is slightly denser than code 39.

CodeI2of5

Code I2of5 is a numeric encoding. The symbol can be as long as necessary


to store the encoded data.

Ean13

EAN-13 was implemented by the International Article Numbering


Association (EAN) in Europe. EAN-13 encodes a 12-digit code that consists
of a 2 digit system code followed by a 5 digit manufacturer code and a 5digit product code. The 12-digit code is followed by a checksum digit
(automatically added by the control).

Ean8

EAN-8 provides a short barcode for small packages. It encodes a 7-digit


code that consists of a 2 or 3 digit system code followed by a 4 or 5 digit
product code. The 7-digit code is followed by a checksum digit
(automatically added by the control).

PostNet

PostNet is a numeric encoding used by the US postal service. It differs from


most others in that it is based on the height of the bars rather than on their
width.

UpcA

UPC-A is the common encoding you will find on virtually every consumer
good on the shelves of your local supermarket, as well as books, magazines,

and newspapers. It is similar to EAN-13, and encodes 11 digits of numeric


data along with a trailing check digit. The first digit determines the number
system, followed by a 5-digit manufacturer code, a 5-digit product code,
and the check digit.
UpcE

UPC-E is a variation of UPC-A which allows for a more compact barcode by


eliminating "extra" zeros. Since the resulting UPC-E barcode is about half the
size as an UPC-A barcode, it is generally used on products with very small
packaging.
When using the UpcE encoding, set the Text property to an 11-digit string
as if you were using the UpcA encoding.
Note that not all UpcA codes can be encoded in UpcE. If the manufacturer
code ends with "000", "100", or "200", the product number must be <= 900.
If the manufacturer code ends with "00" but not with "100", "200", or "300",
then the product number must be <= 90. If the manufacturer code ends
with "0" but not with "00", then the product number must be <= 9. If the
manufacturer code does not end with "0", then the product number must be
between 5 and 9.

Remarks
The CodeTypeEnum enumeration represents the different types of barcode that can be
generated by the C1BarCode control.
Some types of barcode can be used to represent alphanumeric values, others can only
represent numeric values.

Inheritance Hierarchy
System.Object
System.ValueType
System.Enum
C1.Win.C1BarCode.CodeTypeEnum

See Also
Reference
C1.Win.C1BarCode Namespace

Encoding
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : Encoding Enumeration

Specifies the type of encoding to use (more flexible encodings consume more space).

Syntax
Visual Basic (Declaration)
Public Enum Encoding
Inherits System.Enum
C#
public enum Encoding : System.Enum

Members
Member

Description

AlphaNumeric

Encode up to 395 alpha-numeric values. Alpha-numeric values include digits


from 0 to 9, uppercase letters from A to Z, space, and the following
additional characters: dollar, percentage, asterisk, plus, minus, slash, and
colon ([0-9][A-Z][$%*+-./:]).

Automatic

Select encoding automatically based on the content.

Byte

Encode up to 271 bytes.

Numeric

Encode up to 652 numeric values.

Inheritance Hierarchy
System.Object
System.ValueType
System.Enum
C1.Win.C1BarCode.Encoding

See Also
Reference
C1.Win.C1BarCode Namespace

ErrorCorrectionLevel
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : ErrorCorrectionLevel Enumeration

Specifies the error-correction level (higher levels consume more space).

Syntax
Visual Basic (Declaration)
Public Enum ErrorCorrectionLevel
Inherits System.Enum
C#
public enum ErrorCorrectionLevel : System.Enum

Members
Member

Description

Able to correct up to 30% damage.

Able to correct up to 7% damage.

Able to correct up to 15% damage.

Able to correct up to 25% damage.

Inheritance Hierarchy
System.Object
System.ValueType
System.Enum
C1.Win.C1BarCode.ErrorCorrectionLevel

See Also
Reference
C1.Win.C1BarCode Namespace

You might also like