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

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

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

كائن الإشارة المرجعية يمكن أن يكون من أحد نوعين:

• عنصر تحكم المضيف Microsoft.Office.Tools.Word.Bookmark .

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

• كائن Microsoft.Office.Interop.Word.Bookmark أصلي .

  لا يوجد لدى كائنات Microsoft.Office.Interop.Word.Bookmark أحداث أو قدرات لربط البيانات .

عند تعيين نص إلى إشارة مرجعية فإن السلوك يختلف بين Microsoft.Office.Interop.Word.Bookmark و Microsoft.Office.Tools.Word.Bookmark. لمزيد من المعلومات، راجع عنصر تحكم الإشارة المرجعية.

استخدام عناصر تحكم المضيف

لتحديث محتويات الإشارة المرجعية باستخدام عنصر تحكم الإشارة المرجعية

1. قم بإنشاء إجراء يأخذ وسيطة bookmark من أجل اسم الإشارة المرجعية, و وسيطة newText من أجل السلسلة لتعيين الخاصية Text .

   ملاحظة

   تعيين النص إلى خاصية Bookmark.Text أو Bookmark.FormattedText من عنصر التحكم Microsoft.Office.Tools.Word.Bookmark لا يؤدي إلى حذف الإشارة المرجعية .

   Shared Sub BookMarkReplace( _
       ByRef bookmark As Microsoft.Office.Tools.Word.Bookmark, _
       ByVal newText As String)
   

   static void BookMarkReplace(
       ref Microsoft.Office.Tools.Word.Bookmark bookmark, 
       string newText)
   {
   

2. قم بتعيين السلسلة newText إلى الخاصية Text من Microsoft.Office.Tools.Word.Bookmark .

       bookmark.Text = newText
   End Sub
   

       bookmark.Text = newText;
   }
   

استخدام كائنات Word

لتحديث محتويات الإشارة المرجعية باستخدام كائن إشارة مرجعية في Word

1. قم بإنشاء إجراء يحتوي على وسيطة bookmark من أجل اسم الإشارة المرجعية الخاصة بــ Microsoft.Office.Interop.Word.Bookmarkو وسيطةnewText من أجل السلسلة لتعيين الخاصية Range.Text الخاصة بالإشارة المرجعية .

   ملاحظة

   تعيين نص لكائن Word Microsoft.Office.Interop.Word.Bookmark أصلي يؤدي إلى حذف الإشارة المرجعية.

   Friend Sub BookMarkReplaceNative( _
       ByVal bookmark As Word.Bookmark, _
       ByVal newText As String)
   

   internal void BookMarkReplaceNative(
       Word.Bookmark bookmark, 
       string newText)
   {
   

2. قم بتعيين السلسلة newText إلى الخاصية Range.Text من الإشارة المرجعية و التي تحذف الإشارة المرجعية تلقائياً. ثم قم بإعادة إضافة الإشارة المرجعية إلى المجموعة Bookmarks .

   يمكن استخدام مثال التعليمات البرمجية التالي في تخصيص على مستوى المستند.

       Dim rng As Word.Range = bookmark.Range
       Dim bookmarkName As String = bookmark.Name
   
       bookmark.Range.Text = newText
   
       Me.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
   End Sub
   

       object rng = bookmark.Range;
       string bookmarkName = bookmark.Name;
   
       bookmark.Range.Text = newText;
   
       this.Bookmarks.Add(bookmarkName, ref rng); 
   }
   

   يمكن استخدام مثال التعليمة البرمجية التالية في المستوى تطبيق إضافة-في. This مثال uses the نشط مستند.

       Dim rng As Object = bookmark.Range
       Dim bookmarkName As String = bookmark.Name
   
       bookmark.Range.Text = newText
       Me.Application.ActiveDocument.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
   End Sub
   

       object rng = bookmark.Range;
       string bookmarkName = bookmark.Name;
   
       bookmark.Range.Text = newText;
   
       Word.Document document = this.Application.ActiveDocument;
       document.Bookmarks.Add(bookmarkName, ref rng);
   }
   

راجع أيضًا:

المهام

كيفية القيام بما يلي: إدراج نص في مستندات Word

المبادئ

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

موارد أخرى

نظرة عامة على نموذج كائن Word