FieldDisplayBarcode

FieldDisplayBarcode class

ينفذ حقل DISPLAYBARCODE.

لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.

public class FieldDisplayBarcode : Field

المنشئون

اسم	وصف
FieldDisplayBarcode()	Default_Constructor

الخصائص

اسم	وصف
AddStartStopChar { get; set; }	الحصول على أو تعيين ما إذا كان سيتم إضافة أحرف البدء/الإيقاف لأنواع الرموز الشريطية NW7 وCODE39.
BackgroundColor { get; set; }	الحصول على أو تعيين لون خلفية رمز الباركود. القيم الصالحة موجودة في النطاق [0, 0xFFFFFF]
BarcodeType { get; set; }	الحصول على نوع الرمز الشريطي أو تعيينه (QR، وما إلى ذلك)
BarcodeValue { get; set; }	الحصول على قيمة الباركود أو تحديدها.
CaseCodeStyle { get; set; }	الحصول على أو تعيين نمط رمز الحالة لنوع الرمز الشريطي ITF14. القيم الصالحة هي [STD\|EXT\|ADD]
DisplayResult { get; }	الحصول على النص الذي يمثل نتيجة الحقل المعروض.
DisplayText { get; set; }	الحصول على أو تعيين ما إذا كان سيتم عرض بيانات الباركود (النص) مع الصورة.
End { get; }	يحصل على العقدة التي تمثل نهاية الحقل.
ErrorCorrectionLevel { get; set; }	الحصول على أو تعيين مستوى تصحيح الخطأ لرمز الاستجابة السريعة. القيم الصالحة هي [0، 3].
FixCheckDigit { get; set; }	الحصول على أو تحديد ما إذا كان سيتم إصلاح رقم الشيك إذا كان غير صالح.
ForegroundColor { get; set; }	الحصول على أو تعيين اللون الأمامي لرمز الباركود. القيم الصالحة موجودة في النطاق [0, 0xFFFFFF]
Format { get; }	يحصل على`FieldFormat` الكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل.
IsDirty { get; set; }	الحصول على أو تعيين ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب تعديلات أخرى تم إجراؤها على المستند.
IsLocked { get; set; }	الحصول على أو تعيين ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب النتيجة).
LocaleId { get; set; }	الحصول على أو تعيين LCID الخاص بالحقل.
PosCodeStyle { get; set; }	الحصول على أو تعيين نمط الرمز الشريطي لنقطة البيع (أنواع الرموز الشريطية UPCA\|UPCE\|EAN13\|EAN8). القيم الصالحة (غير حساسة لحالة الأحرف) هي [STD\|SUP2\|SUP5\|CASE].
Result { get; set; }	الحصول على أو تعيين النص الموجود بين فاصل الحقل ونهاية الحقل.
ScalingFactor { get; set; }	الحصول على أو تحديد عامل القياس للرمز. القيمة بنقاط مئوية كاملة والقيم الصالحة هي [10, 1000]
Separator { get; }	يحصل على العقدة التي تمثل فاصل الحقول. يمكن ان يكون`باطل` .
Start { get; }	يحصل على العقدة التي تمثل بداية الحقل.
SymbolHeight { get; set; }	الحصول على أو تحديد ارتفاع الرمز. الوحدات في TWIPS (1/1440 بوصة).
SymbolRotation { get; set; }	الحصول على أو ضبط دوران رمز الباركود. القيم الصالحة هي [0, 3]
virtual Type { get; }	الحصول على نوع حقل Microsoft Word.

طُرق

اسم	وصف
GetFieldCode()	إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية.
GetFieldCode(bool)	إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل).
Remove()	إزالة الحقل من المستند. إرجاع عقدة مباشرة بعد الحقل. إذا كانت نهاية الحقل هي الطفل الأخير للعقدة الأصلية، فسيتم إرجاع الفقرة الأصلية الخاصة به. إذا تمت إزالة الحقل بالفعل، فسيتم إرجاعه`باطل` .
Unlink()	يقوم بإلغاء ربط الحقل.
Update()	يقوم بإجراء التحديث الميداني. يتم الرمي إذا تم تحديث الحقل بالفعل.
Update(bool)	إجراء تحديث ميداني. يتم الرمي إذا تم تحديث الحقل بالفعل.

ملاحظات

إدراج رمز شريطي.

أمثلة

يوضح كيفية إجراء دمج البريد على رموز QR الشريطية.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// أدخل حقل MERGEBARCODE، الذي سيقبل القيم من مصدر البيانات أثناء دمج البريد.
// سيقوم هذا الحقل بتحويل كافة القيم الموجودة في عمود "MyQRCode" الخاص بمصدر بيانات الدمج إلى رموز QR.
FieldMergeBarcode field = (FieldMergeBarcode)builder.InsertField(FieldType.FieldMergeBarcode, true);
field.BarcodeType = "QR";
field.BarcodeValue = "MyQRCode";

// تطبيق الألوان والقياس المخصص.
field.BackgroundColor = "0xF8BD69";
field.ForegroundColor = "0xB5413B";
field.ErrorCorrectionLevel = "3";
field.ScalingFactor = "250";
field.SymbolHeight = "1000";
field.SymbolRotation = "0";

Assert.AreEqual(FieldType.FieldMergeBarcode, field.Type);
Assert.AreEqual(" MERGEBARCODE  MyQRCode QR \\b 0xF8BD69 \\f 0xB5413B \\q 3 \\s 250 \\h 1000 \\r 0",
    field.GetFieldCode());
builder.Writeln();

// قم بإنشاء DataTable بعمود يحمل نفس اسم قيمة BarcodeValue لحقل MERGEBARCODE الخاص بنا.
// سيؤدي دمج البريد إلى إنشاء صفحة جديدة لكل صف. ستحتوي كل صفحة على حقل DISPLAYBARCODE،
// والذي سيعرض رمز الاستجابة السريعة بالقيمة من الصف المدمج.
DataTable table = new DataTable("Barcodes");
table.Columns.Add("MyQRCode");
table.Rows.Add(new[] { "ABC123" });
table.Rows.Add(new[] { "DEF456" });

doc.MailMerge.Execute(table);

Assert.AreEqual(FieldType.FieldDisplayBarcode, doc.Range.Fields[0].Type);
Assert.AreEqual("DISPLAYBARCODE \"ABC123\" QR \\q 3 \\s 250 \\h 1000 \\r 0 \\b 0xF8BD69 \\f 0xB5413B", 
    doc.Range.Fields[0].GetFieldCode());
Assert.AreEqual(FieldType.FieldDisplayBarcode, doc.Range.Fields[1].Type);
Assert.AreEqual("DISPLAYBARCODE \"DEF456\" QR \\q 3 \\s 250 \\h 1000 \\r 0 \\b 0xF8BD69 \\f 0xB5413B",
    doc.Range.Fields[1].GetFieldCode());

doc.Save(ArtifactsDir + "Field.MERGEBARCODE.QR.docx");

يوضح كيفية إدراج حقل DISPLAYBARCODE وتعيين خصائصه.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

FieldDisplayBarcode field = (FieldDisplayBarcode)builder.InsertField(FieldType.FieldDisplayBarcode, true);

// فيما يلي أربعة أنواع من الرموز الشريطية، مزينة بطرق مختلفة، والتي يمكن أن يعرضها حقل DISPLAYBARCODE.
// 1 - رمز QR بألوان مخصصة:
field.BarcodeType = "QR";
field.BarcodeValue = "ABC123";
field.BackgroundColor = "0xF8BD69";
field.ForegroundColor = "0xB5413B";
field.ErrorCorrectionLevel = "3";
field.ScalingFactor = "250";
field.SymbolHeight = "1000";
field.SymbolRotation = "0";

Assert.AreEqual(" DISPLAYBARCODE  ABC123 QR \\b 0xF8BD69 \\f 0xB5413B \\q 3 \\s 250 \\h 1000 \\r 0", field.GetFieldCode());
builder.Writeln();

// 2 - الرمز الشريطي EAN13، مع عرض الأرقام أسفل الأشرطة:
field = (FieldDisplayBarcode)builder.InsertField(FieldType.FieldDisplayBarcode, true);
field.BarcodeType = "EAN13";
field.BarcodeValue = "501234567890";
field.DisplayText = true;
field.PosCodeStyle = "CASE";
field.FixCheckDigit = true;

Assert.AreEqual(" DISPLAYBARCODE  501234567890 EAN13 \\t \\p CASE \\x", field.GetFieldCode());
builder.Writeln();

// 3 - الرمز الشريطي CODE39:
field = (FieldDisplayBarcode)builder.InsertField(FieldType.FieldDisplayBarcode, true);
field.BarcodeType = "CODE39";
field.BarcodeValue = "12345ABCDE";
field.AddStartStopChar = true;

Assert.AreEqual(" DISPLAYBARCODE  12345ABCDE CODE39 \\d", field.GetFieldCode());
builder.Writeln();

// 4 - الرمز الشريطي ITF4، مع رمز الحالة المحدد:
field = (FieldDisplayBarcode)builder.InsertField(FieldType.FieldDisplayBarcode, true);
field.BarcodeType = "ITF14";
field.BarcodeValue = "09312345678907";
field.CaseCodeStyle = "STD";

Assert.AreEqual(" DISPLAYBARCODE  09312345678907 ITF14 \\c STD", field.GetFieldCode());

doc.Save(ArtifactsDir + "Field.DISPLAYBARCODE.docx");

أنظر أيضا

class Field
مساحة الاسم Aspose.Words.Fields
المجسم Aspose.Words

FieldDdeAuto Class FieldDocProperty Class