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; } | يحصل على مستوى تصحيح خطأ رمز الاستجابة السريعة (QR) أو يضبطه. القيم الصالحة هي [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();
// قم بإنشاء جدول بيانات بعمود يحمل نفس اسم 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 - رمز الاستجابة السريعة مع الألوان المخصصة:
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
