عنصر تحكم الإشارة المرجعية

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

عنصر تحكم Microsoft.Office.Tools.Word.Bookmark هو إشارة مرجعية تحتوي على اسم فريد، يعرض أحداثا و يمكن ربطه بالبيانات. يمكن استخدام الإشارة المرجعية كعنصر نائب لوضع علامة على عنصر أو موقع في مستند Microsoft Office Word. عنصر التحكم Microsoft.Office.Tools.Word.Bookmark يتركب من كائن Microsoft.Office.Interop.Word.Bookmark وكائن Microsoft.Office.Interop.Word.Range .

في المشاريع علي مستوي المستند, يمكنك إضافة عناصر تحكم المحتوى Microsoft.Office.Tools.Word.Bookmark إلى المستند الخاص بك في وقت التشغيل أو في وقت التصميم. في المشاريع على مستوى التطبيق، يمكنك إضافة عناصر تحكم Microsoft.Office.Tools.Word.Bookmark إلى أي مستند مفتوح في وقت التشغيل. لمزيد من المعلومات، راجع كيفية القيام بما يلي: إضافة عناصر تحكم الإشارة المرجعية إلى مستندات Word.

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

يدعم عنصر التحكم Microsoft.Office.Tools.Word.Bookmark ربط البيانات البسيط . يجب أن تكون الإشارة المرجعية مرتبطة بمصدر البيانات عن طريق استخدام الخاصية DataBindings خاصية ربط البيانات الافتراضية الخاصة بالإشارة المرجعية هي خاصية Text

إذا تم تحديث البيانات في مجموعة البيانات، فإن عنصر التحكم Microsoft.Office.Tools.Word.Bookmark يعكس التغييرات.

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

تنسيق

التنسيقات التي يمكن تطبيقها على Microsoft.Office.Interop.Word.Bookmark يمكن تطبيقها على عنصر تحكم Microsoft.Office.Tools.Word.Bookmark. يتضمن ذلك الخطوط , المسافات البادئة ، التباعد ، الترقيم و الأنماط.

تعيين نص إلى إشارة مرجعية

فرق إضافي بين كائن Microsoft.Office.Interop.Word.Bookmark وعنصر التحكم Microsoft.Office.Tools.Word.Bookmark في كيفية التصرف عند تعيين نص إلى الإشارة المرجعية. إذا قمت بتعيين النص إلى Microsoft.Office.Interop.Word.Bookmark بطول صفر، يتم إلحاق النص إلى يمين الإشارة المرجعية و تبقى الإشارة المرجعية بالطول صفر. ومع ذلك، إذا قمت بتعيين نص إلى الطول صفر Microsoft.Office.Tools.Word.Bookmark ،يتم إدراج النص إلى الإشارة المرجعية ويتم توسبع طول الإشارة المرجعية إلى العدد الإجمالي للأحرف التي تم إدراجها.

عنصر التحكم Microsoft.Office.Tools.Word.Bookmark يحتوي أيضاً على خاصية Bookmark.Text . تختلف عن خاصية Range.Text التي تتوفر على خاصية Range لعنصر التحكم Microsoft.Office.Tools.Word.Bookmark أو خاصية Range من الكائن Microsoft.Office.Interop.Word.Bookmark.

خاصية النص (Text)	الوصف
Bookmark.Text	استخدم هذه الخاصية لعرض نص ضمن الإشارة المرجعية وترك الإشارة المرجعية على المستند. تعيين نص إلى الإشارة المرجعية يوسع نطاق الإشارة المرجعية و لا يحذف الإشارة المرجعية. على سبيل المثال، Bookmark1.Text = "Hello world" يدرج نصاً إلى الإشارة المرجعية و يترك الإشارة المرجعية سليمة.
Range.Text	استخدم هذه الخاصية لعرض نص في موقع الإشارة المرجعية و حذف الإشارة المرجعية تلقائياً. على سبيل المثال، يقوم Bookmark1.Range.Text = "Hello world" بإدراج نص إلى الإشارة المرجعية و يحذف الإشارة المرجعية.

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

في المشاريع على مستوى المستند، عند سحب عنصر تحكم Microsoft.Office.Tools.Word.Bookmark من مربع الأدوات إلى المستند الخص بك ,يقوم Visual Studio تلقائياً بإنشاء اسم لعنصر التحكم. يمكنك تغيير اسم عنصر التحكم في النافذة خصائص .

تراكب عناصر التحكم

يمكن لعناصر تحكم الإشارة المرجعية أن يتراكب بعضها فوق بعض; بمعنى أن نفس النص يمكن مشاركته بواسطة أكثر من إشارة مرجعية واحدة. عند تعيين نص جديد إلى واحدة من الإشارات المرجعية المتراكبة, سوف تحتوي على نص جديد و لن يتم تراكب الإشارات المرجعية بعد ذلك. تحتوي الآن الإشارة المرجعية الأخرى فقط على النص الذي لم يعد مشتركاً بين الإشارات المرجعية المتراكبة الأصلية.

الجدول التالي يوضح كيفية مشاركة جملة “This is sample text. ” من قبل اثنين من الإشارات المرجعية المتراكبة.

إشارة مرجعية	Text
تراكب الإشارات المرجعية	[this is {sample] text.}
Bookmark1	This is sample
Bookmark2	sample text.

إذا قمت بتعيين النص الجديد "This is replacement" إلى Bookmark1 ، لم تعد الإشارات المرجعية متراكبة و يحتفظ Bookmark2 فقط بالنص الذى لم يكن فى الأصل جزءاً من Bookmark1.

إشارة مرجعية	Text
اثنين من الإشارات المرجعية المنفصلة	[this is replacement]{ text.}
Bookmark1	This is replacement
Bookmark2	.text

إذا كانت الإشارة المرجعية تحوي بشكل كامل على إشارة مرجعية أخرى ثم قمت بتغيير الإشارة المرجعية الخارجية ,لا يتم حذف الإشارة المرجعية الداخلية. وعلى الرغم من ذلك، تصبح الإشارة المرجعية الداخلية فارغة و يتم نقلها إلى نهاية الإشارة المرجعية الخارجية. الجدول التالي يوضح كيفية مشاركة الجملة "This is sample text." بواسطة إشارة مرجعية موجودة ضمن إشارة مرجعية آخرى.

إشارة مرجعية	Text
تراكب الإشارات المرجعية	[this is {sample} text.]
Bookmark1	This is sample text.
Bookmark2	sample

إذا قمت بتعيين النص الجديد "This is replacement." إلى Bookmark1 ،لم تعد الإشارات المرجعية متراكبة و يصبح Bookmark2 إشارة مرجعية فارغة تقع في نهاية Bookmark1.

إشارة مرجعية	Text
اثنين من الإشارات المرجعية المنفصلة	[this is replacement.]{}
Bookmark1	This is replacement.
Bookmark2	<فارغة>

أحداث

الأحداث التالية متوفرة لعنصر التحكم Microsoft.Office.Tools.Word.Bookmark:

• BeforeDoubleClick

• BeforeRightClick

• BindingContextChanged

• Deselected

• Disposed

• Selected

• SelectionChange

راجع أيضًا:

المهام

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

الإرشادات التفصيلية: إنشاء قوائم مختصرة للإشارات المرجعية

المبادئ

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

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

موارد أخرى

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