عنصر تحكم XMLNodes

هامتعيين المعلومات في هذا الموضوع بتقديم regarding ‏‫برنامج ‏‫برنامج Microsoft الكلمة خصيصا للفائدة واستخدام الأفراد والشركات الذين تقع خارج الولايات المتحدة والمناطق الخاصة بها أو ممن يستخدمون، أو تطوير البرامج تشغيل تشغيل?، منتجات ‏‫برنامج ‏‫برنامج Microsoft الكلمة التي كانت حاصلة Microsoft Office 2010 Suite قبل يناير 2010، عند تمت إزالته Microsoft Office 2010 Suite تنفيذ وظائف معينة ذات صلة ب XML المخصص من ‏‫برنامج ‏‫برنامج Microsoft الكلمة. هذه المعلومات فيما يتعلق Microsoft Office 2010 Suite الكلمة قد لا يتم قراءة أو المستخدمة من قبل الأفراد أو الشركات في الولايات المتحدة أو المناطق الخاصة بها والذين يستخدمون، أو تطوير البرامج التشغيل هذه في ‏‫برنامج ‏‫برنامج Microsoft الكلمة المنتجات التي كانت مرخصة من قبل Microsoft Office 2010 Suite بعد 10 يناير 2010،؛ هذه المنتجات لا ستسلك نفس المنتجات المرخصة من قبل هذا التاريخ أو شراء و مرخصة للاستخدام خارج الولايات المتحدة.

ينطبق على

تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع.

نوع المشروع

  • مشروعات على مستوى المستند

إصدار Microsoft Office

  • Word 2007

  • Word 2010

عنصر التحكم XMLNodes عبارة عن مجموعة من كائنات عقدة XML معيّنة تكشف عن الأحداث. عنصر تحكم XMLNodes يتم إنشاؤه عندما يتم تعيين عنصر مخطط مكرر إلى مستندات Microsoft Office Word. إذا كان عنصر التكرار يحتوي على عناصر تابعة، كل من العناصر التابعة يتم أيضاً إنشاؤه كعنصر تحكم XMLNodes .

بعد إنشاء Visual Studio لمجموعة عقد XML ، يمكنك برمجة عنصر التحكم مباشرة دون الحاجة إلى اجتياز نموذج كائن Word. عنصر التحكم XMLNodes يمكن حذفه فقط عن طريق إزالة العنصر المعين في Word.

ملاحظة

إذا قمت بالوصول إلى عنصر تابع لعنصر التحكم XMLNodes خلال الخاصية Item ، تقوم هى بإرجاع الكائن Microsoft.Office.Interop.Word.XMLNode بدلاً من عنصر التحكم Microsoft.Office.Tools.Word.XMLNode . لمزيد من المعلومات، راجع القيود البرمجية للعناصر مضيفة وعناصر التحكم.

ربط البيانات إلى عنصر التحكم

عنصر التحكم XMLNodes لا يدعم ربط البيانات. وهذا لأن عنصر التحكم XMLNodes لا يحظى بقدرات ربط بيانات معقد و لا يمكن لربط بيانات بسيط أن يمثل بيانات مكررة.

تنسيق

أي تنسيق يمكن تطبيقه على النص ضمن المستند يمكن تطبيقه على عنصر التحكم XMLNodes .

أحداث

الأحداث المتوفرة لعنصر التحكم XMLNodes هي:

مقارنة الأحداث

يمكنك التقاط حدث عندما يقوم المستخدم بتحريك المؤشر الخاص به داخل سياق عنصر تحكم XMLNodes محدد . على سبيل المثال، قد يكون لديك عنصر تحكم XMLNodesيسمى Customer له عنصر تحكم تابع XMLNodes باسم Company ، و Company له عنصري تحكم تابعين XMLNodes باسم CompanyName و CompanyRegion كما يلي:

<Customer>
    <Company>
        <CompanyName>
        <CompanyRegion>

إذا كنت ترغب في إظهار عنصر تحكم في جزء الإجراءات كلما انتقل المؤشر إلى العقدة Company ، ينبغى أن لا يهم ما إذا كان المؤشر قد تم وضعه في CompanyName أو CompanyRegion لأنها كليهما ضمن السياق Company. في هذه الحالة، يمكنك كتابة التعليمات البرمجية في الحدث ContextEnter من Company.

في معظم الحالات، عندما يقوم المؤشر بإدخال عنصر التحكم XMLNodes ، كلا الأحداث Select و ContextEnter يتم تشغيلها. يعرض الجدول التالي الاختلافات بين هذه الأحداث.

حدد حدث

حدث ContextEnter

يحدث عند وضع المؤشر داخل إحدى عقد مجموعة XMLNodes .

يحدث عند وضع المؤشر داخل إحدى العقد أو العقد التابعة من مجموعة XMLNodes من منطقة خارج سياق عقدة. بمعنى آخر، فإنه يظهر فقط عند تغيير السياق و يمكن رفعه لعناصر التحكم XMLNodes المتعددة المتداخلة .

على سبيل المثال، عند تحريك المؤشر خارج Customer إلى CompanyName ، يتم رفع الأحداث ContextEnter الخاصة بـ Customer ، Company ، و CompanyName . إذا قمت بنقل المؤشر من CompanyName إلى CompanyRegion ، يتم رفع الحدث ContextEnter الخاص بــ CompanyRegion ، لأن السياق هو نفسه لكل من Company و Customer. يمكن أن يكون لديك عقد Company متعددة في المستند الخاص بك. إذا قمت بتحريك المؤشر من عقدة CompanyName لواحدة من Company إلى عقدة CompanyName الخاصة بــ Company أخرى ، السياق هو نفسه ، لذا يتم رفع حدث Select فقط .

الاختلافات نفسها موجودة بين الحدث ContextLeave و الحدث Deselect .

راجع أيضًا:

المهام

كيفية القيام بما يلي: إضافة عناصر تحكم XMLNodes إلى مستندات Word

كيفية القيام بما يلي: تعيين مخططات إلى مستندات Word داخل Visual Studio

المبادئ

نظرة عامة حول العناصر المضيفة و عناصر تحكم المضيف

أتمتة Word عن طريق استخدام الكائنات الموسعة

عنصر التحكم XMLNode

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