This topic provides conceptual information about the
igQRCodeBarcode™ control including its main features and minimum requirements.
The following concept is required as a prerequisite to understanding this topic:
This topic contains the following sections:
igQRCodeBarcode control generates QR (Quick Response) barcode images for use in your web application. The following screenshot shows a sample
igQRCodeBarcode control with the “http://www.infragistics.com” data encoded.
The control supports the industry-standard encodings and has several options for optimizing the sizing, positioning, and readability of the generated QR barcodes.
igQRCodeBarcode control is configurable in terms of QR-code-specific settings, as well as in look-and-feel (background color, border color and thickness). For details, see Main features summary chart.
The following table summarizes the main features of the
igQRCodeBarcode control. For further details, refer to the Configuring igQRCodeBarcode group of topics.
|Size, stretch, and fill||Configurable dimensions||
If the width and height properties have
not been set for the
|Configurable Minimum-Size Element||The minimum-size element width for the matrix affects size of the matrix itself and is related to the available space on the page and the technology used to decode the QR barcode, i.e. mobile phones, etc.. The size of the minimum-size element is managed by the xDimension property.|
|Configurable stretch||The stretch controls the spread of the QR barcode matrix within the control’s container in both horizontal and vertical directions.|
The various bars comprising the barcode matrix comprises are visualized in a logical grid. The barsFillMode property of the
|QR-code-specific||Configurable Error Correction Level||
|Configurable Size Version||
|Configurable Encoding Mode||
|Configurable Extended Channel Interpretation (ECI) Number||
|Configurable FNC1 Mode||
|Configurable Application Indicator||
In case that
|Look-and-feel||Configurable barcode bars’ color||You can set the color of the barcode.|
|Configurable background color||You can specify the color of the background area behind the bars of the barcode.|
|Configurable border thickness and color||You can customize the barcode’s border thickness and color.|
The minimum configuration of
igQRCodeBarcode which is needed in order to have the control operational is to specify its dimensions (width and height) and feed data to it by setting a value to the data option.
Note: Depending on the type of data to be encoded, additional encoding files might need to be loaded and the
eciNumbermight need to be set (see the Configuring the Character Encoding (igQRCodeBarcode) topic for details).
If the width and height options have not been set for the
igQRCodeBarcode control, it is sized according to the size of its container (if defined).
By default, if the aspect ratio of the available space for rendering the control differs from that of its content, the content is resized to fit in the destination's dimensions while it preserves its native aspect ratio (1:1) (the default value of the stretch property being uniform).
The various bars comprising the barcode matrix are visualized in a logical grid. By default, this grid fills all the space available for the
barsFillMode = ”fillSpace”).
The default configuration specifies a data recovery level at the 15% of the damaged symbols (
errorCorrectionLevel = "medium").
If the size version of the QR code barcode matrix has not been explicitly set, the smallest size version that accommodates the data will be used (
sizeVersion = "undefined").
In order to ensure minimum size of the files, carrying the encodings logic, the default values of the following two properties vary according to the selected encoding:
encodingModeresolves to undefined if the Shift_JIS encoding has been loaded and to byte otherwise
eciNumberresolves to “3” (ISO-8859-1 character set) if ISO-8859-1 character set has been loaded; otherwise it resolves to “26” (UTF-8 character set)
The following topics provide additional information related to this topic.
Adding igQRCodeBarcode: This is a group of topics demonstrating how to add the
igQRCodeBarcode control to an HTML page and to an ASP.NET MVC application.
Configuring igQRCodeBarcode: This is a group of topics explaining how to configure the
igQRCodeBarcode control’s dimensions, character encoding, and QR-code-specific settings.
Styling igQRCodeBarcode: This topic explains how to configure the look-and-feel of the
igQRCodeBarcode control be setting the barcode color, the background color, and the border color and thickness.
Accessibility Compliance (igQRCodeBarcode): This topic explains the accessibility features of the
igQRCodeBarcode control and provides advice on how to achieve accessibility compliance for pages containing barcodes.
Known Issues and Limitations (igQRCodeBarcode): This topic provides information on the known issues and limitations of the
jQuery and MVC API Links (igQRCodeBarcode): This topic provides links to the API reference documentation about the
igQRCodeBarcode control and the ASP.NET MVC Helper for it.
The following samples provide additional information related to this topic.
Configuring the QR-Code-Specific Settings: This sample demonstrates configuring the QR-code-specific settings.
QR Barcode Dimensions: This sample demonstrates configuring the dimensions’ settings of the
Configuring Colors: This sample demonstrates styling the
igQRCodeBarcode control by configuring the colors used in the barcode.
View on GitHub