Professional Documents
Culture Documents
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.
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
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
Key Features
The C1BarCode is a royalty-free DLL that can be deployed with your applications like
any regular assembly.
See Also
Step 1: Setting Up the Project
Step 2: Adding Code to the Project
Step 3: Running the Project
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.
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
Copy Code
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
Copy Code
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
Copy Code
{
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.
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.
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
Code_128_A
Code_128_B
Code_128_C
Code_128auto
Code_2_of_5
Code93
Code25intlv
Interleaved 2 of 5 uses
only numbers.
Code39
Code39x
Code49
DataMatrix
EAN_13
EAN_8
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:
FNC (function) 1
character which
allows scanners to
identify this as an
EAN-128 barcode
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
JapanesePostal
Matrix 2 of 5 is a higher
density barcode consisting
of 3 black bars and 2 white
bars.
MicroPDF417
MSI
Pdf417
PostNet
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
RSS14
RSS14 is a 14-digit
Reduced Space Symbology
that uses EAN.UCC item
identification for point-ofsale omnidirectional
scanning.
RSS14Stacked
RSS14StackedOmnidirectio
RSS14StackedOmnidirectio
nal
RSS14Truncated
RSSExpanded
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
UPC_A
UPC_E0
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 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.
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.
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
C1QRCode
Strings
Strings.Errors
Enumerations
Enumeration
Description
BarDirectionEnum
CodeTypeEnum
Encoding
See Also
Reference
C1.Win.C1BarCode.4 Assembly
Classes
C1BarCode
Members Example
C1.Win.C1BarCode.4 Assembly > C1.Win.C1BarCode Namespace : C1BarCode Class
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
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
Public Constructors
Name
Description
Public Properties
Name
Description
AccessibilityObject
AccessibleName
AccessibleRole
AllowDrop
Anchor
AutoScrollOffset
BackColor
BackgroundImage
BackgroundImageLayout
BarDirection
BarHeight
BarNarrow
BarWide
BindingContext
Bottom
Bounds
CanFocus
CanSelect
Capture
CausesValidation
ClientRectangle
ClientSize
CodeType
CompanyName
Container
ContainsFocus
ContextMenu
ContextMenuStrip
Controls
Created
Cursor
DataBindings
DisplayRectangle
Disposing
Dock
Enabled
EncodingException
Focused
Font
ForeColor
Handle
HasChildren
Height
Image
ImeMode
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
LayoutEngine
Left
Location
Margin
MaximumSize
MinimumSize
Name
Padding
Parent
PreferredSize
ProductName
ProductVersion
RecreatingHandle
Region
Right
RightToLeft
ShowText
Site
Size
SizeMode
TabIndex
TabStop
Tag
Text
Top
TopLevelControl
UseWaitCursor
Visible
Width
Top
Public Methods
Name
Description
BeginInvoke
BringToFront
Contains
CreateControl
CreateGraphics
CreateObjRef
Dispose
DoDragDrop
DrawToBitmap
EndInvoke
FindForm
Focus
GetChildAtPoint
GetContainerControl
GetImage
GetLifetimeService
GetNextControl
GetPreferredSize
Hide
InitializeLifetimeService
Invalidate
Invoke
PerformLayout
PointToClient
PointToScreen
RectangleToClient
RectangleToScreen
Refresh
ResetText
ResumeLayout
Scale
Select
SelectNextControl
SendToBack
SetBounds
Show
SuspendLayout
ToString
Update
Top
Public Events
Name
Description
BackColorChanged
BackgroundImageChanged
BindingContextChanged
CausesValidationChanged
ChangeUICues
Click
ClientSizeChanged
ContextMenuChanged
ContextMenuStripChanged
ControlAdded
ControlRemoved
CursorChanged
Disposed
DockChanged
DoubleClick
DragDrop
DragEnter
DragLeave
DragOver
EnabledChanged
Enter
FontChanged
ForeColorChanged
GiveFeedback
GotFocus
HandleCreated
HandleDestroyed
HelpRequested
ImeModeChanged
Invalidated
KeyDown
KeyPress
KeyUp
Layout
Leave
LocationChanged
LostFocus
MarginChanged
MouseCaptureChanged
MouseClick
MouseDoubleClick
MouseDown
MouseEnter
MouseHover
MouseLeave
MouseMove
MouseUp
MouseWheel
Move
PaddingChanged
Paint
ParentChanged
PreviewKeyDown
QueryAccessibilityHelp
QueryContinueDrag
RegionChanged
Resize
RightToLeftChanged
SizeChanged
StyleChanged
SystemColorsChanged
TabIndexChanged
TabStopChanged
TextChanged
Validated
Validating
VisibleChanged
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
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
Public Methods
Name
Description
BeginInvoke
BringToFront
Contains
CreateControl
CreateGraphics
CreateObjRef
Dispose
DoDragDrop
DrawToBitmap
EndInvoke
FindForm
Focus
GetChildAtPoint
GetContainerControl
GetImage
GetLifetimeService
GetNextControl
GetPreferredSize
Hide
InitializeLifetimeService
Invalidate
Invoke
PerformLayout
PointToClient
PointToScreen
RectangleToClient
RectangleToScreen
Refresh
ResetText
ResumeLayout
Scale
Select
SelectNextControl
SendToBack
SetBounds
Show
SuspendLayout
ToString
Update
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)
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
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
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
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
Public Properties
Name
Description
AccessibilityObject
AccessibleName
AccessibleRole
AllowDrop
Anchor
AutoScrollOffset
BackColor
BackgroundImage
BackgroundImageLayout
BarDirection
BarHeight
BarNarrow
BarWide
BindingContext
Bottom
Bounds
CanFocus
CanSelect
Capture
CausesValidation
ClientRectangle
ClientSize
CodeType
CompanyName
Container
ContainsFocus
ContextMenu
ContextMenuStrip
Controls
Created
Cursor
DataBindings
DisplayRectangle
Disposing
Dock
Enabled
EncodingException
Focused
Font
ForeColor
Handle
HasChildren
Height
Image
ImeMode
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
LayoutEngine
Left
Location
Margin
MaximumSize
MinimumSize
Name
Padding
Parent
PreferredSize
ProductName
ProductVersion
RecreatingHandle
Region
Right
RightToLeft
ShowText
Site
Size
SizeMode
TabIndex
TabStop
Tag
Text
Top
TopLevelControl
UseWaitCursor
Visible
Width
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
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
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
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
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
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
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
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
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
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#
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
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#
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
Public Constructors
Name
Description
Public Properties
Name
Description
AccessibilityObject
AccessibleName
AccessibleRole
AllowDrop
Anchor
AutoScrollOffset
BackColor
BackgroundImage
BackgroundImageLayout
BindingContext
Bottom
Bounds
CanFocus
CanSelect
Capture
CausesValidation
ClientRectangle
ClientSize
CodeVersion
CompanyName
Container
ContainsFocus
ContextMenu
ContextMenuStrip
Controls
Created
Cursor
DataBindings
DisplayRectangle
Disposing
Dock
Enabled
Encoding
EncodingException
ErrorCorrectionLevel
Focused
ForeColor
Handle
HasChildren
Height
Image
ImeMode
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
LayoutEngine
Left
Location
Margin
MaximumSize
MinimumSize
Name
Padding
Parent
PreferredSize
ProductName
ProductVersion
RecreatingHandle
Region
Right
RightToLeft
Site
Size
SizeMode
SymbolSize
TabIndex
TabStop
Tag
Text
Top
TopLevelControl
UseWaitCursor
Visible
Width
Top
Public Methods
Name
Description
BeginInvoke
BringToFront
Contains
CreateControl
CreateGraphics
CreateObjRef
Dispose
DoDragDrop
DrawToBitmap
EndInvoke
FindForm
Focus
GetChildAtPoint
GetContainerControl
GetImage
GetLifetimeService
GetNextControl
GetPreferredSize
Hide
InitializeLifetimeService
Invalidate
Invoke
PerformLayout
PointToClient
PointToScreen
RectangleToClient
RectangleToScreen
Refresh
ResetText
ResumeLayout
Scale
Select
SelectNextControl
SendToBack
SetBounds
Show
SuspendLayout
ToString
Update
Top
Public Events
Name
Description
BackColorChanged
BackgroundImageChanged
CausesValidationChanged
ChangeUICues
Click
ClientSizeChanged
ContextMenuChanged
ContextMenuStripChanged
ControlAdded
ControlRemoved
CursorChanged
Disposed
DockChanged
DoubleClick
DragDrop
DragEnter
DragLeave
DragOver
EnabledChanged
Enter
FontChanged
ForeColorChanged
GiveFeedback
GotFocus
HandleCreated
HandleDestroyed
HelpRequested
ImeModeChanged
Invalidated
KeyDown
KeyPress
KeyUp
Layout
Leave
LocationChanged
LostFocus
MarginChanged
MouseCaptureChanged
MouseClick
MouseDoubleClick
MouseDown
MouseEnter
MouseHover
MouseLeave
MouseMove
MouseUp
MouseWheel
Move
PaddingChanged
Paint
ParentChanged
PreviewKeyDown
QueryAccessibilityHelp
QueryContinueDrag
RegionChanged
Resize
RightToLeftChanged
SizeChanged
StyleChanged
SystemColorsChanged
TabIndexChanged
TabStopChanged
TextChanged
Validated
Validating
VisibleChanged
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
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
Public Methods
Name
Description
BeginInvoke
BringToFront
Contains
CreateControl
CreateGraphics
CreateObjRef
Dispose
DoDragDrop
DrawToBitmap
EndInvoke
FindForm
Focus
GetChildAtPoint
GetContainerControl
GetImage
GetLifetimeService
GetNextControl
GetPreferredSize
Hide
InitializeLifetimeService
Invalidate
Invoke
PerformLayout
PointToClient
PointToScreen
RectangleToClient
RectangleToScreen
Refresh
ResetText
ResumeLayout
Scale
Select
SelectNextControl
SendToBack
SetBounds
Show
SuspendLayout
ToString
Update
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)
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
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
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
Public Properties
Name
Description
AccessibilityObject
AccessibleName
AccessibleRole
AllowDrop
Anchor
AutoScrollOffset
BackColor
BackgroundImage
BackgroundImageLayout
BindingContext
Bottom
Bounds
CanFocus
CanSelect
Capture
CausesValidation
ClientRectangle
ClientSize
CodeVersion
CompanyName
Container
ContainsFocus
ContextMenu
ContextMenuStrip
Controls
Created
Cursor
DataBindings
DisplayRectangle
Disposing
Dock
Enabled
Encoding
EncodingException
ErrorCorrectionLevel
Focused
ForeColor
Handle
HasChildren
Height
Image
ImeMode
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
LayoutEngine
Left
Location
Margin
MaximumSize
MinimumSize
Name
Padding
Parent
PreferredSize
ProductName
ProductVersion
RecreatingHandle
Region
Right
RightToLeft
Site
Size
SizeMode
SymbolSize
TabIndex
TabStop
Tag
Text
Top
TopLevelControl
UseWaitCursor
Visible
Width
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Syntax
Visual Basic (Declaration)
Members
Member
Description
Down
Normal
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
Syntax
Visual Basic (Declaration)
Public Enum CodeTypeEnum
Inherits System.Enum
C#
public enum CodeTypeEnum : System.Enum
Members
Member
Description
Codabar
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
Code93
CodeI2of5
Ean13
Ean8
PostNet
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,
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
Automatic
Byte
Numeric
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
Syntax
Visual Basic (Declaration)
Public Enum ErrorCorrectionLevel
Inherits System.Enum
C#
public enum ErrorCorrectionLevel : System.Enum
Members
Member
Description
Inheritance Hierarchy
System.Object
System.ValueType
System.Enum
C1.Win.C1BarCode.ErrorCorrectionLevel
See Also
Reference
C1.Win.C1BarCode Namespace