Enum QREncodeMode

Namespace: Aspose.BarCode.Generation
Assembly: Aspose.BarCode.dll (25.1.0)

حالت کدگذاری برای بارکدهای QR.

public enum QREncodeMode

فیلدها

Auto = 0

در حالت خودکار، متن کد با حداکثر فشردگی داده کدگذاری می‌شود. کاراکترهای یونیکد در حالت کانجی کدگذاری می‌شوند اگر ممکن باشد، یا اینکه دوباره در کدگذاری مشخص شده ECIEncoding با درج یک شناسه ECI کدگذاری می‌شوند. اگر کاراکتری پیدا شود که توسط کدگذاری ECI انتخاب شده پشتیبانی نمی‌شود، یک استثنا پرتاب می‌شود.

Binary = 7

در حالت باینری، متن کد با حداکثر فشردگی داده کدگذاری می‌شود. اگر کاراکتر یونیکدی پیدا شود، یک استثنا پرتاب می‌شود.

Bytes = 1

متن کد را به عنوان بایت‌های ساده کدگذاری کنید. اگر هر کاراکتر یونیکدی شناسایی شود، کاراکتر به عنوان دو بایت کدگذاری می‌شود، بایت پایین‌تر اول.

ECI = 8

در حالت ECI، کل پیام دوباره در کدگذاری مشخص شده ECIEncoding با درج یک شناسه ECI کدگذاری می‌شود. اگر کاراکتری پیدا شود که توسط کدگذاری ECI انتخاب شده پشتیبانی نمی‌شود، یک استثنا پرتاب می‌شود. لطفاً توجه داشته باشید که برخی از اسکنرهای قدیمی (قبل از 2006) ممکن است از این حالت پشتیبانی نکنند. این حالت توسط بارکدهای MicroQR پشتیبانی نمی‌شود.

ECIEncoding = 4

متن کد را با مقدار تعیین شده در ویژگی ECIEncoding کدگذاری کنید. ممکن است با برخی از اسکنرهای بارکد قدیمی (قبل از 2006) مشکلاتی وجود داشته باشد. این حالت توسط بارکدهای MicroQR پشتیبانی نمی‌شود.

Extended = 6

حالت کانال گسترش‌یافته که از موقعیت اول FNC1، موقعیت دوم FNC1 و حالت‌های چند ECI پشتیبانی می‌کند.

بهتر است از QrExtCodetextBuilder برای تولید متن کد گسترش‌یافته استفاده کنید.

از ویژگی Display2DText برای تنظیم متن قابل مشاهده برای حذف کاراکترهای مدیریتی استفاده کنید.

اصول کدگذاری:

تمام نمادها "\" باید در متن کد دو برابر "\\" شوند.

FNC1 در موقعیت اول در متن کد به عنوان "<FNC1>" تنظیم می‌شود.

FNC1 در موقعیت دوم در متن کد به عنوان "<FNC1(value)>" تنظیم می‌شود. مقدار باید نمادهای تکی (a-z، A-Z) یا اعداد از 0 تا 99 باشد.

فاصله‌گذار گروه برای حالت‌های FNC1 به عنوان کاراکتر 0x1D '\\u001D' تنظیم می‌شود.

اگر نیاز دارید که رشته "<FNC1>" را به بارکد وارد کنید، آن را به عنوان "<\FNC1>" بنویسید.

شناسه‌های ECI به عنوان یک اسلش تکی و شناسه شش رقمی "\000026" - شناسه ECI UTF8 تنظیم می‌شوند.

برای غیرفعال کردن حالت ECI فعلی و تبدیل به حالت پیش‌فرض JIS8، شناسه ECI حالت صفر تنظیم می‌شود. "\000000"

تمام کاراکترهای یونیکد پس از شناسه ECI به طور خودکار به مجموعه کد کاراکتر صحیح کدگذاری می‌شوند.

این حالت توسط بارکدهای MicroQR پشتیبانی نمی‌شود.

ExtendedCodetext = 5

حالت کانال گسترش‌یافته که از موقعیت اول FNC1، موقعیت دوم FNC1 و حالت‌های چند ECI پشتیبانی می‌کند.

بهتر است از QrExtCodetextBuilder برای تولید متن کد گسترش‌یافته استفاده کنید.

از ویژگی Display2DText برای تنظیم متن قابل مشاهده برای حذف کاراکترهای مدیریتی استفاده کنید.

اصول کدگذاری:

تمام نمادها "\" باید در متن کد دو برابر "\\" شوند.

FNC1 در موقعیت اول در متن کد به عنوان "<FNC1>" تنظیم می‌شود.

FNC1 در موقعیت دوم در متن کد به عنوان "<FNC1(value)>" تنظیم می‌شود. مقدار باید نمادهای تکی (a-z، A-Z) یا اعداد از 0 تا 99 باشد.

فاصله‌گذار گروه برای حالت‌های FNC1 به عنوان کاراکتر 0x1D '\\u001D' تنظیم می‌شود.

اگر نیاز دارید که رشته "<FNC1>" را به بارکد وارد کنید، آن را به عنوان "<\FNC1>" بنویسید.

شناسه‌های ECI به عنوان یک اسلش تکی و شناسه شش رقمی "\000026" - شناسه ECI UTF8 تنظیم می‌شوند.

برای غیرفعال کردن حالت ECI فعلی و تبدیل به حالت پیش‌فرض JIS8، شناسه ECI حالت صفر تنظیم می‌شود. "\000000"

تمام کاراکترهای یونیکد پس از شناسه ECI به طور خودکار به مجموعه کد کاراکتر صحیح کدگذاری می‌شوند.

این حالت توسط بارکدهای MicroQR پشتیبانی نمی‌شود.

Utf16BEBOM = 3

متن کد را با کدگذاری UTF8 با کاراکتر ByteOfMark اول کدگذاری کنید. ممکن است با برخی از اسکنرهای بارکد مشکلاتی وجود داشته باشد.

Utf8BOM = 2

متن کد را با کدگذاری UTF8 با کاراکتر ByteOfMark اول کدگذاری کنید.

مثال‌ها

این نمونه‌ها نشان می‌دهند که چگونه بارکد QR را با فرمت‌های داده گسترش‌یافته کدگذاری و ذخیره کنید.

csharp
//این نمونه نشان می‌دهد که چگونه از کدگذاری ECI استفاده کنید و یک تصویر بارکد ذخیره کنید.

[C#]
using (Aspose.BarCode.Generation.BarcodeGenerator generator = new Aspose.BarCode.Generation.BarcodeGenerator(EncodeTypes.QR))
{
    generator.CodeText = "12345TEXT";
    generator.Parameters.Barcode.QR.QrEncodeMode = QREncodeMode.ECIEncoding;
    generator.Parameters.Barcode.QR.QrECIEncoding = ECIEncodings.UTF8;
    generator.Save("test.png");
}
Using generator As New Aspose.BarCode.Generation.BarcodeGenerator(EncodeTypes.QR)
    generator.CodeText = "12345TEXT"
    generator.Parameters.Barcode.QR.QrEncodeMode = QREncodeMode.ECIEncoding
    generator.Parameters.Barcode.QR.QrECIEncoding = ECIEncodings.UTF8
    generator.Save("test.png")
End Using

//این نمونه نشان می‌دهد که چگونه از موقعیت اول FNC1 در حالت گسترش‌یافته استفاده کنید.

//حالت کانال گسترش‌یافته که از موقعیت اول FNC1، موقعیت دوم FNC1 و حالت‌های چند ECI پشتیبانی می‌کند.
//بهتر است از QrExtCodetextBuilder برای تولید متن کد گسترش‌یافته استفاده کنید.
//از ویژگی Display2DText برای تنظیم متن قابل مشاهده برای حذف کاراکترهای مدیریتی استفاده کنید.
//اصول کدگذاری:
//تمام نمادها "\" باید در متن کد دو برابر "\\" شوند.
//FNC1 در موقعیت اول در متن کد به عنوان "&lt;FNC1&gt;" تنظیم می‌شود.
//FNC1 در موقعیت دوم در متن کد به عنوان "&lt;FNC1(value)&gt;" تنظیم می‌شود. مقدار باید نمادهای تکی (a-z، A-Z) یا اعداد از 0 تا 99 باشد.
//فاصله‌گذار گروه برای حالت‌های FNC1 به عنوان کاراکتر 0x1D '\\u001D' تنظیم می‌شود.
//اگر نیاز دارید که رشته "&lt;FNC1&gt;" را به بارکد وارد کنید، آن را به عنوان "&lt;\FNC1&gt;" بنویسید.
//شناسه‌های ECI به عنوان یک اسلش تکی و شناسه شش رقمی "\000026" - شناسه ECI UTF8 تنظیم می‌شوند.
//برای غیرفعال کردن حالت ECI فعلی و تبدیل به حالت پیش‌فرض JIS8، شناسه ECI حالت صفر تنظیم می‌شود. "\000000"
//تمام کاراکترهای یونیکد پس از شناسه ECI به طور خودکار به مجموعه کد کاراکتر صحیح کدگذاری می‌شوند.

[C#]
//ایجاد متن کد
QrExtCodetextBuilder textBuilder = new QrExtCodetextBuilder();
textBuilder.AddFNC1FirstPosition();
textBuilder.AddPlainCodetext("000%89%%0");
textBuilder.AddFNC1GroupSeparator();
textBuilder.AddPlainCodetext("12345&lt;FNC1&gt;");
//تولید بارکد
using (Aspose.BarCode.Generation.BarcodeGenerator generator = new Aspose.BarCode.Generation.BarcodeGenerator(EncodeTypes.QR))
{
    generator.CodeText = textBuilder.GetExtendedCodetext();
    generator.Parameters.Barcode.QR.QrEncodeMode = QREncodeMode.Extended;
    generator.Parameters.Barcode.CodeTextParameters.TwoDDisplayText = "My Text";
    generator.Save(@"d:\test.png");
}
'ایجاد متن کد
Dim textBuilder As New QrExtCodetextBuilder()
textBuilder.AddFNC1FirstPosition()
textBuilder.AddPlainCodetext("000%89%%0")
textBuilder.AddFNC1GroupSeparator()
textBuilder.AddPlainCodetext("12345&lt;FNC1&gt;")
'تولید بارکد
Using generator As New Aspose.BarCode.Generation.BarcodeGenerator(EncodeTypes.QR)
    generator.CodeText = textBuilder.GetExtendedCodetext()
    generator.Parameters.Barcode.QR.QrEncodeMode = QREncodeMode.Extended
    generator.Parameters.Barcode.CodeTextParameters.TwoDDisplayText = "My Text"
    generator.Save("test.png")
End Using

//این نمونه نشان می‌دهد که چگونه از موقعیت دوم FNC1 در حالت گسترش‌یافته استفاده کنید.

[C#]
//ایجاد متن کد
QrExtCodetextBuilder textBuilder = new QrExtCodetextBuilder();
textBuilder.AddFNC1SecondPosition("12");
textBuilder.AddPlainCodetext("TRUE3456"); 
//تولید بارکد
using (Aspose.BarCode.Generation.BarcodeGenerator generator = new Aspose.BarCode.Generation.BarcodeGenerator(EncodeTypes.QR))
{
    generator.CodeText = textBuilder.GetExtendedCodetext();
    generator.Parameters.Barcode.QR.QrEncodeMode = QREncodeMode.Extended;
    generator.Parameters.Barcode.CodeTextParameters.TwoDDisplayText = "My Text";
    generator.Save(@"d:\test.png");
}
'ایجاد متن کد
Dim textBuilder As New QrExtCodetextBuilder()
textBuilder.AddFNC1SecondPosition("12")
textBuilder.AddPlainCodetext("TRUE3456")
'تولید بارکد
Using generator As New Aspose.BarCode.Generation.BarcodeGenerator(EncodeTypes.QR)
    generator.CodeText = textBuilder.GetExtendedCodetext()
    generator.Parameters.Barcode.QR.QrEncodeMode = QREncodeMode.Extended
    generator.Parameters.Barcode.CodeTextParameters.TwoDDisplayText = "My Text"
    generator.Save("test.png")
End Using

//این نمونه نشان می‌دهد که چگونه از حالت چند ECI در حالت گسترش‌یافته استفاده کنید.

[C#]
//ایجاد متن کد
QrExtCodetextBuilder textBuilder = new QrExtCodetextBuilder();
textBuilder.AddECICodetext(ECIEncodings.Win1251, "Will");
textBuilder.AddECICodetext(ECIEncodings.UTF8, "Right");
textBuilder.AddECICodetext(ECIEncodings.UTF16BE, "Power");
textBuilder.AddPlainCodetext(@"t\e\\st");   
//تولید بارکد
using (Aspose.BarCode.Generation.BarcodeGenerator generator = new Aspose.BarCode.Generation.BarcodeGenerator(EncodeTypes.QR))
{
    generator.CodeText = textBuilder.GetExtendedCodetext();
    generator.Parameters.Barcode.QR.QrEncodeMode = QREncodeMode.Extendedt;
    generator.Parameters.Barcode.CodeTextParameters.TwoDDisplayText = "My Text";
    generator.Save(@"d:\test.png");
}
'ایجاد متن کد
Dim textBuilder As New QrExtCodetextBuilder()
textBuilder.AddECICodetext(ECIEncodings.Win1251, "Will")
textBuilder.AddECICodetext(ECIEncodings.UTF8, "Right")
textBuilder.AddECICodetext(ECIEncodings.UTF16BE, "Power")
textBuilder.AddPlainCodetext(@"t\e\\st") 
'تولید بارکد
Using generator As New Aspose.BarCode.Generation.BarcodeGenerator(EncodeTypes.QR)
    generator.CodeText = textBuilder.GetExtendedCodetext()
    generator.Parameters.Barcode.QR.QrEncodeMode = QREncodeMode.Extended
    generator.Parameters.Barcode.CodeTextParameters.TwoDDisplayText = "My Text"
    generator.Save("test.png")
End Using