كيفية العمل مع الحقول الانتقالية في .NET

الخطوة 1: العثور على الحقول الانتقالية في مستند

قم بتعداد Document.Range.Fields وقارن قيمة Type لكل حقل (قيمة FieldType) بالثوابت ذات الصلة — FieldBarcode، FieldDisplayBarcode، FieldMergeBarcode، FieldBidiOutline، FieldEQ، FieldFootnoteRef أو FieldInfo — ثم قم بتحويل الكائن العام Field إلى الفئة المطابقة للوصول إلى خصائصه المحددة. تحقق دائمًا من Type قبل التحويل: التحويل إلى فئة حقل خاطئة يطلق InvalidCastException.

الخطوة 2: تكوين حقل DISPLAYBARCODE أو MERGEBARCODE

FieldDisplayBarcode (حقل DISPLAYBARCODE) و FieldMergeBarcode (حقل MERGEBARCODE، الذي يطبق أيضًا IMergeFieldSurrogate للدمج البريدي) يشتركان في نفس مجموعة خصائص تكوين الباركود: BarcodeType، BarcodeValue، SymbolHeight، SymbolRotation، ScalingFactor، ForegroundColor، BackgroundColor، PosCodeStyle، CaseCodeStyle، ErrorCorrectionLevel، DisplayText، AddStartStopChar، و FixCheckDigit. اضبط هذه على نسخة الحقل، ثم استدعِ Update() لكي يعكس Result التكوين الجديد قبل حفظ المستند.

الخطوة 3: قراءة بيانات حقل BARCODE (البريدي) القديم

FieldBarcode يُنفّذ الحقل BARCODE الأقدم، وهو حقل باركود بريدي أمريكي (POSTNET) تحديدًا وليس باركودًا متعدد الأغراض — لا يشارك خصائص BarcodeType/BarcodeValue من الخطوة 2. بدلاً من ذلك يكشف عن PostalAddress (العنوان الذي يُشفّرّه الباركود)، FacingIdentificationMark، IsUSPostalAddress، وIsBookmark. تحقق من Field.Type مقابل FieldType.FieldBarcode تحديدًا قبل قراءة هذه الخصائص، لأن تحويل حقل DISPLAYBARCODE أو MERGEBARCODE إلى FieldBarcode لن يُظهر الخصائص التي تتوقعها.

الخطوة 4: إنشاء صور الباركود باستخدام مولد مخصص

تحتوي نسخة FOSS هذه على بيانات حقول الباركود لكنها لا تتضمن محركًا لتصوير الباركود. BarcodeParameters هو الحاوية العابرة التي توحّد الإعدادات من أي عائلة حقول باركود — خصائص DISPLAYBARCODE/MERGEBARCODE من الخطوة 2 والخصائص البريدية من الخطوة 3 — في كائن واحد يُسلم إلى المرسِّم. نفّذ IBarcodeGenerator، مكشفًا عن GetBarcodeImage(parameters) وGetOldBarcodeImage(parameters) القديم، لتوفير تصوير الصورة الفعلي؛ بدون تنفيذ مُقدَّم، تحمل حقول الباركود بيانات التكوين فقط.

الخطوة 5: العمل مع حقول التوافق القديمة

أربع فئات أخرى تغطي رموز الحقول الأقدم التي لا تزال موجودة في ملفات .docx القديمة. FieldBidiOutline يُنفّذ حقل BIDIOUTLINE لترقيم المخطط من اليمين إلى اليسار ولا يكشف عن أي خصائص بخلاف السطح المشترك Field. FieldEQ يُنفّذ حقل المعادلة EQ ويكشف إضافيًا عن AsOfficeMath() لتحويل محتواه إلى كائن OfficeMath — هذا ينجح فقط عندما يكون الحقل يُشفّر معادلة فعليًا. FieldFootnoteRef يُنفّذ حقل FOOTNOTEREF، الذي يربط إشارة بحاشية أو هوامش نهائية، ولا يكشف أيضًا عن أي خصائص بخلاف السطح المشترك Field. FieldInfo يُنفّذ حقل INFO، قراءة أو كتابة خاصية معلومات ملخص المستند عبر خصائصه InfoType وNewValue.

الخطوة 6: تحديث أو تجميد قيمة حقل انتقالي

كل فئة حقل انتقالي ترث GetFieldCode() (نص الشيفرة الأساسي للحقل)، Update() (يعيد تقييم النتيجة)، Unlink() (يستبدل الحقل بنتيجته الأخيرة المحسوبة كنص ثابت)، وRemove() (يحذف الحقل). استدعِ Update() بعد تغيير أي تكوين للحقل لكي يعكس Result التغيير، واستخدم Unlink() عندما يجب تجميد القيمة الحالية للحقل بدلاً من بقائها قابلة لإعادة الحساب.