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

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

في المشاريع على مستوى المستند ، يمكنك إضافة عناصر تحكم Bookmark إلى المستند في المشروع الخاص بك في وقت التصميم أو في وقت التشغيل. في المشاريع على مستوى التطبيق، يمكنك إضافة عناصر تحكم Bookmark إلى أي مستند مفتوح في وقت التشغيل.

يصف هذا الموضوع المهام التالية:

• إضافة عناصر تحكم الإشارة المرجعية في وقت التصميم

• إضافة عناصر تحكم الإشارة المرجعية في وقت التشغيل في مشروع على مستوى المستند

• إضافة عناصر التحكم الإشارة المرجعية في وقت التشغيل في مشروع على مستوى التطبيق

لمزيد من المعلومات حول عناصر تحكم Bookmark ، راجع عنصر تحكم الإشارة المرجعية.

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

هناك عدة طرق لإضافة عناصر تحكم Bookmark إلى المستند في مشروع على مستوى المستند في وقت التصميم:

• من مربع الأدواتفى Visual Studio.

  يمكنك سحب عنصر التحكم Bookmark من مربع الأدوات إلى المستند الخاص بك. قد تحتاج إلى اختيار هذه الطريقة إذا كنت بالفعل تقوم باستخدام مربع الأدوات لإضافة عناصر تحكم Windows Forms إلى المستند الخاص بك.

• من داخل Word.

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

• من النافذة مصادر البيانات.

  يمكنك سحب عنصر التحكم Bookmark إلى المستند الخاص بك من النافذة مصادر البيانات . وهذا مفيد عندما تريد ربط عنصر تحكم بالبيانات في نفس الوقت. يمكنك التحكم في عنصر التحكم المضيف بنفس الطريقة التي تضيف بها عنصر تحكم Windows Form من الإطار مصادر البيانات. لمزيد من المعلومات، راجع ربط البيانات "و" نماذج Windows.

ملاحظة

قد يعرض جهاز الكمبيوتر الخاص بك أسماء أو مواقع مختلفة لبعض عناصر واجهة مستخدم Visual Studio في الإرشادات التالية. يحدد كل من إصدار Visual Studio لديك والإعدادات المستخدمة هذه العناصر. لمزيد من المعلومات، راجع العمل مع إعدادات.

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

1. قم بفتح مربع الأدوات وانقر فوق علامة التبويب عناصر تحكم Word.

2. قم بسحب عنصر تحكم Bookmark إلى المستند.

   يظهر مربع الحوار أضف إشارة مرجعية.

3. حدد النص أو العناصر الأخرى التي تريد تضمينها في الإشارة المرجعية.

4. انقر فوق موافق.

   إذا لم تكن تريد الاحتفاظ باسم الإشارة المرجعية الافتراضية ، يمكنك تغيير الاسم في النافذة خصائص.

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

1. في المستند الذي تتم استضافته في مصمم Visual Studio ، ضع المؤشر حيث تريد إضافة الإشارة المرجعية أو حدد النص الذي تريد من الإشارة المرجعية الإحاطة به.

2. على علامة التبويب إدراج من الشريط، في المجموعة الروابط انقر فوق زر إشارة مرجعية.

3. في مربع الحوار إشارة مرجعية اكتب اسم الإشارة المرجعية الجديد وانقر فوق أضف .

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

يمكنك إضافة عناصر تحكمBookmarkبرمجيًا إلى مستندك في وقت التشغيل باستخدام أساليب الخاصيةControls من الفئة ThisDocument في مشروعك. هناك اثنان من التحميلات الزائدة للأساليب يمكن أن تقوم باستخدامها لإضافة عنصر تحكم Bookmark بالطرق التالية:

• قم بإضافة Bookmarkفي نطاق محدد.

• قم بإضافة Bookmark يعتمد على إشارة مرجعية أصلية في المستند (وهو Microsoft.Office.Interop.Word.Bookmark).

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

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

• في معالج الأحداث ThisDocument_Startup في مشروعك ، قم بإدراج التعليمات البرمجية التالية لإضافة عنصر التحكم Bookmark إلى الفقرة الأولى في المستند.

  Dim firstParagraph As Microsoft.Office.Tools.Word.Bookmark
  firstParagraph = Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "FirstParagraph")
  

  Microsoft.Office.Tools.Word.Bookmark firstParagraph;
  firstParagraph = this.Controls.AddBookmark(this.Paragraphs[1].Range,
      "FirstParagraph");
  

  ملاحظة

  إذا كنت تريد إنشاء عنصر تحكم Microsoft.Office.Tools.Word.Bookmark من Microsoft.Office.Interop.Word.Bookmark موجود، استخدم الأسلوب AddBookmark و مرر إليه Microsoft.Office.Interop.Word.Bookmark الموجود .

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

يمكنك إضافة Bookmarkعناصر تحكم برمجياً إلى أي مستند مفتوح في وقت التشغيل بواسطة تستخدم المستوى تطبيق إضافة-بوصة للقيام بترتيب هو، إنشاء Documentمضيف العنصر الذي هو على مستند مفتوح، وبعد ذلك باستخدام الأساليب الخاصة Controlsخاصية th هو استضافة عنصر. هناك اثنان من التحميلات الزائدة للأساليب يمكن أن تقوم باستخدامها لإضافة عنصر تحكم Bookmark بالطرق التالية:

• قم بإضافة Bookmarkفي نطاق محدد.

• قم بإضافة Bookmark يعتمد على إشارة مرجعية أصلية في المستند (وهو Microsoft.Office.Interop.Word.Bookmark).

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

للمزيد من المعلومات حول إنشاء عناصر مضيفة في مشاريع على مستوى التطبيق، راجع توسيع مستندات Word ومصنفات Excel في وظائف إضافية على مستوى التطبيق في وقت التشغيل.

لإضافة عنصر تحكم الإشارة المرجعية في نطاق محدد

• استخدم الأسلوب ControlCollection.AddBookmark(Range, String) و مرر Range حيث تريد إضافة Bookmark.

  مثال التعليمات البرمجية التالي يضيف Bookmark جديد لبداية المستند النشط. لاستخدام هذا المثال، قم بتشغيل التعليمات البرمجية من معالج الأحداث ThisAddIn_Startup في مشروع وظيفة Word الإضافية.

  ' Use the following line of code in projects that target the .NET Framework 4.
  Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
  
  ' In projects that target the .NET Framework 3.5, use the following line of code.
  ' Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()
  
  Dim firstParagraph As Bookmark = extendedDocument.Controls.AddBookmark( _
      extendedDocument.Paragraphs(1).Range, "FirstParagraph")
  

  // Use the following line of code in projects that target the .NET Framework 4.
  Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
  
  // In projects that target the .NET Framework 3.5, use the following line of code.
  // Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();
  
  Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
      extendedDocument.Paragraphs[1].Range, "FirstParagraph");
  

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

• استخدم الأسلوب ControlCollection.AddBookmark(Bookmark, String) و مرر Microsoft.Office.Interop.Word.Bookmark الموجود التي تريد استخدامه كأساس لـ Bookmark الجديد .

  مثال التعليمة البرمجية التالية يقوم بإنشاء Bookmark جديد مستند إلى Microsoft.Office.Interop.Word.Bookmark الأول في المستند النشط. لاستخدام هذا المثال، قم بتشغيل التعليمات البرمجية من معالج الأحداث ThisAddIn_Startup في مشروع وظيفة Word الإضافية.

  If Me.Application.ActiveDocument.Bookmarks.Count > 0 Then
      Dim firstBookmark As Word.Bookmark = Me.Application.ActiveDocument.Bookmarks(1)
  
      ' Use the following line of code in projects that target the .NET Framework 4.
      Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
  
      ' In projects that target the .NET Framework 3.5, use the following line of code.
      ' Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()
  
      Dim vstoBookmark As Bookmark = extendedDocument.Controls.AddBookmark( _
          firstBookmark, "VSTOBookmark")
  End If
  

  if (this.Application.ActiveDocument.Bookmarks.Count > 0)
  {
      object index = 1;
      Word.Bookmark firstBookmark = this.Application.ActiveDocument.Bookmarks.get_Item(ref index);
  
      // Use the following line of code in projects that target the .NET Framework 4.
      Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
  
      // In projects that target the .NET Framework 3.5, use the following line of code.
      // Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();
  
      Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
              firstBookmark, "VSTOBookmark");
  }
  

راجع أيضًا:

المهام

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

المبادئ

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

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

إضافة عناصر تحكم إلى مستندات Office في وقت التشغيل

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

أساليب مساعدة لعناصر تحكم المضيف

موارد أخرى

برمجة وظائف إضافية على مستوى التطبيق

برمجة تخصيصات علي مستوي مستند