العمل مع التحكم في المحتوى SDT

في Microsoft Word، يمكنك إنشاء نموذج عن طريق البدء بقالب وإضافة عناصر تحكم في المحتوى، بما في ذلك checkboxإس ومربعات النص وجامعي التاريخ والقوائم المنسدلة. في Aspose.Words، يتم استيراد علامة مستند منظم أو عنصر تحكم في المحتوى من أي مستند تم تحميله في Aspose.Words كعقدة StructuredDocumentTag. تسمح علامات المستندات المنظمة (SDT أو التحكم في المحتوى) بتضمين الدلالات المحددة من قبل العميل بالإضافة إلى سلوكها ومظهرها في مستند.

StructuredDocumentTag يمكن أن يحدث في مستند في الأماكن التالية:

• مستوى الكتلة-بين الفقرات والجداول، كطفل لجسم، HeaderFooter، تعليق، حاشية سفلية أو عقدة شكل.
• مستوى الصف-بين الصفوف في الجدول، كطفل لعقدة الجدول.
• مستوى الخلية - بين الخلايا في صف جدول، كطفل لعقدة صف.
• المستوى المضمن-بين المحتوى المضمن في الداخل، كطفل لفقرة.
• متداخلة داخل آخر StructuredDocumentTag.

إدراج عناصر تحكم المحتوى في مستند

في هذا الإصدار من Aspose.Words، يمكن إنشاء الأنواع التالية من SDT أو التحكم في المحتوى:

• Checkbox
• DropDownList
• ComboBox
• التاريخ
• BuildingBlockGallery
• المجموعة
• Picture
• RichText
• PlainText

يوضح مثال التعليمات البرمجية التالية كيفية إنشاء عنصر تحكم المحتوى من النوع checkbox:

يوضح مثال التعليمات البرمجية التالية كيفية إنشاء عنصر تحكم المحتوى من نوع مربع النص المنسق:

يوضح مثال التعليمات البرمجية التالية كيفية إنشاء عنصر تحكم المحتوى من نوع مربع التحرير والسرد:

كيفية تحديث عناصر التحكم في المحتوى

يشرح هذا القسم كيفية تحديث قيم SDT أو التحكم في المحتوى برمجيا.

يوضح مثال الكود التالي كيفية تعيين الحالة الحالية لـ checkbox:

يوضح مثال التعليمات البرمجية التالية كيفية تعديل عناصر التحكم في المحتوى من نوع مربع نص عادي والقائمة المنسدلة والصورة:

يمكنك تنزيل نموذج ملف هذه الأمثلة من Aspose.Words GitHub.

ربط التحكم في المحتوى إلى أجزاء XML مخصصة

يمكنك ربط عناصر التحكم في المحتوى ببيانات XML (custom XML part) في مستندات ورد.

يوضح مثال التعليمات البرمجية التالية كيفية ربط عنصر تحكم المحتوى إلى أجزاء XML مخصصة:

مسح محتويات عنصر تحكم المحتوى

يمكنك مسح محتويات عنصر تحكم المحتوى مع عرض عنصر نائب. تقوم طريقة StructuredDocumentTag.clear() بمسح محتويات علامة المستند المهيكلة هذه وعرض عنصر نائب إذا تم تعريفه. ومع ذلك، لا يمكن مسح محتويات عنصر تحكم المحتوى إذا كان يحتوي على مراجعات. إذا لم يكن عنصر تحكم المحتوى يحتوي على عنصر نائب، فسيتم إدراج خمس مسافات كما هو الحال في MS كلمة (باستثناء الأقسام المتكررة، وعناصر القسم المتكررة، والمجموعات، وخانات الاختيار، والاستشهادات). إذا تم تعيين عنصر تحكم المحتوى إلى مخصص XML، يتم مسح العقدة XML المشار إليها.

يوضح مثال الكود التالي كيفية مسح محتوى التحكم في المحتوى:

تغيير خلفية التحكم في المحتوى وألوان الحدود

تتيح لك خاصية StructuredDocumentTag.Color الحصول على لون التحكم في المحتوى أو تعيينه. يؤثر اللون على التحكم في المحتوى في حالتين:

1. MS كلمة يسلط الضوء على خلفية عنصر تحكم المحتوى عندما يتحرك الماوس فوق عنصر تحكم المحتوى. هذا يساعد على تحديد التحكم في المحتوى. لون تسليط الضوء هو “ليونة” قليلا من Color. على سبيل المثال، MS كلمة يسلط الضوء على الخلفية مع اللون الوردي، عندما Color أحمر.
2. عندما تتفاعل (التحرير، الانتقاء، إلخ) مع عنصر التحكم في المحتوى، يتم تلوين حدود عنصر التحكم في المحتوى بـ Color.

يوضح مثال التعليمات البرمجية التالية كيفية تغيير لون عنصر تحكم المحتوى:

كيفية تعيين نمط لتنسيق النص المكتوب في عنصر تحكم المحتوى

إذا كنت تريد تعيين نمط التحكم في المحتوى، فيمكنك استخدام خصائص StructuredDocumentTag.Style أو StructuredDocumentTag.StyleName. عند كتابة النص في عنصر تحكم المحتوى في مستند الإخراج، سيكون للنص المكتوب النمط"اقتباس".

لاحظ أنه يمكن تطبيق أنماط الأحرف المرتبطة فقط على التحكم في المحتوى. يتم طرح InvalidOperationException (“لا يمكن تطبيق هذا النمط على SDT”) عند تطبيق نمط موجود ولكنه غير مرتبط أو يتم تطبيق نمط الحرف.

يوضح مثال التعليمات البرمجية التالية كيفية تعيين نمط التحكم في المحتوى:

العمل مع التحكم في محتوى القسم المتكرر

يسمح التحكم في محتوى قسم التكرار بتكرار المحتوى الموجود بداخله. باستخدام Aspose.Words، يمكن إنشاء عقد علامة المستند المهيكلة لقسم التكرار وأنواع عناصر القسم المتكرر ولهذا الغرض، يوفر SdtType نوع التعداد REPEATING_SECTION_ITEM عضوا.

يوضح مثال التعليمات البرمجية التالية كيفية ربط عنصر تحكم محتوى مقطع مكرر بجدول: