مشاركة عبر

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

  • مقالة

ينطبق على

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

نوع المشروع

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

  • مشروعات على مستوى التطبيق

إصدار Microsoft Office

  • Excel 2007 و Excel 2010

  • Word 2007 و Word 2010

يمكنك إضافة عناصر تحكم Windows Forms إلى مستندات Microsoft Office Excel و Microsoft Office Word في وقت التصميم في المشاريع على مستوى المستند. في وقت التشغيل ، يمكنك إضافة عناصر تحكم في تخصيصات على مستوى المستند وفي الوظائف الإضافية على مستوى التطبيق . على سبيل المثال، يمكنك إضافة عنصر التحكم ComboBox إلى ورقة العمل الخاصة بك بحيث يمكن للمستخدمين التحديد من قائمة الخيارات.

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

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

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

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

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

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

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

ملاحظة

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

لسحب عناصر تحكم Windows Forms إلى المستند

  1. قم بإنشاء أو فتح مشروع مصنف Excel أو مشروع مستند Word في Visual Studio بحيث يكون المستند مرئياً في المصمم. للحصول على معلومات حول إنشاء المشاريع راجع كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio.

  2. في التبويب عناصر تحكم شائعة فى مربع الأدوات، انقر فوق عنصر التحكم الذي تريد إضافته و اسحبه إلى المستند.

    ملاحظة

    عند تحديدك لعنصر تحكم في Excel, سوف ترى ("WinForms.Control.Host","") EMBED في شريط الصيغة. هذا النص ضروري، لا ينبغى حذفه.

لرسم عنصر تحكم Windows Forms في المستند

  1. قم بإنشاء أو فتح مشروع مصنف Excel أو مشروع مستند Word في Visual Studio بحيث يكون المستند مرئياً في المصمم. للحصول على معلومات حول إنشاء المشاريع راجع كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio.

  2. في التبويب عناصر تحكم شائعة من مربع أدوات ، انقر فوق عنصر التحكم الذي تريد إضافته.

  3. في المستند، انقر فوق المكان الذى تريده مكانا للزاوية اليسرى العليا لعنصر التحكم واسحب إلى المكان الذى تريده مكانا للزاوية السفلية اليسرى من عنصر التحكم .

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

    ملاحظة

    عند تحديدك لعنصر تحكم في Excel, سوف ترى ("WinForms.Control.Host","") EMBED في شريط الصيغة. هذا النص ضروري، لا ينبغى حذفه.

لإضافة أحد عناصر تحكم Windows Forms إلى المستند عن طريق النقر المفرد فوق عنصر التحكم

  1. قم بإنشاء أو فتح مشروع مصنف Excel أو مشروع مستند Word في Visual Studio بحيث يكون المستند مرئياً في المصمم. للحصول على معلومات حول إنشاء المشاريع راجع كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio.

  2. في التبويب عناصر تحكم شائعة فى مربع الأدوات، انقر فوق عنصر التحكم الذي تريد إضافته.

  3. فوق المستند، انقر حيث تريد إضافة عنصر التحكم .

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

    ملاحظة

    عند تحديدك لعنصر تحكم في Excel, سوف ترى ("WinForms.Control.Host","") EMBED في شريط الصيغة. هذا النص ضروري، لا ينبغى حذفه.

لإضافة أحد عناصر تحكم Windows Forms إلى المستند عن طريق النقر المزدوج فوق عنصر التحكم

  1. قم بإنشاء أو فتح مشروع مصنف Excel أو مشروع مستند Word في Visual Studio بحيث يكون المستند مرئياً في المصمم. للحصول على معلومات حول إنشاء المشاريع راجع كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio.

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

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

    ملاحظة

    عند تحديدك لعنصر تحكم في Excel, سوف ترى ("WinForms.Control.Host","") EMBED في شريط الصيغة. هذا النص ضروري، لا ينبغى حذفه.

لإضافة أحد عناصر تحكم Windows Forms إلى المستند عن طريق الضغط فوق زر ENTER

  1. قم بإنشاء أو فتح مشروع مصنف Excel أو مشروع مستند Word في Visual Studio بحيث يكون المستند مرئياً في المصمم. للحصول على معلومات حول إنشاء المشاريع راجع كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio.

  2. في التبويب عناصر تحكم شائعة من مربع أدوات ، انقر فوق عنصر التحكم الذي تريد إضافته ، ثم اضغط فوق المفتاح ENTER.

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

    ملاحظة

    عند تحديدك لعنصر تحكم في Excel, سوف ترى ("WinForms.Control.Host","") EMBED في شريط الصيغة. هذا النص ضروري، لا ينبغى حذفه.

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

يمكنك إضافة عناصر تحكم Windows Forms برمجياً إلى مستند في وقت التشغيل . في Word، استخدم أساليب الخاصية Controls من الفئة ThisDocument . في Excel، استخدم أساليب الخاصية Controls من الفئة Sheetn . يحتوي كل أسلوب على العديد من التحميلات الزائدة التي تتيح لك تحديد موقع عنصر التحكم بطرق مختلفة. لمزيد من المعلومات، راجع الأساليب المساعدة لعناصر تحكم Windows Forms.

عند إضافة عناصر تحكم Windows Forms إلى مستند في وقت التشغيل ، لا يظل عنصر التحكم في المستند عند إغلاق المستند. يمكنك إعادة إنشاء عنصر التحكم المرة التالية التي يتم فيها فتح المستند. لمزيد من المعلومات، راجع إضافة عناصر تحكم إلى مستندات Office في وقت التشغيل.

لإضافة أحد عناصر تحكم Windows Forms في وقت التشغيل

  • استخدم الأسلوب المسمى Add < فئة عنصر التحكم > (حيث فئة عنصر التحكم هو اسم فئة عناصر تحكم Windows Forms التي تريد إضافتها, مثل AddButton()).

    يوضح مثال التعليمات البرمجية التالي كيفية إضافة Button إلى الخلية C5 من Sheet1 في مشروع على مستوى المستند لـ Excel.

    Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

    Dim salesButton As Microsoft.Office.Tools.Excel.Controls.Button
    salesButton = Me.Controls.AddButton(Me.Range("C5"), "salesButton")
    salesButton.Text = "Calculate Total Sales"
End Sub

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.Controls.Button salesButton;
    salesButton = this.Controls.AddButton(this.get_Range("C5", missing), "salesButton");
    salesButton.Text = "Calculate Total Sales";
}

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

يمكنك إضافة عناصر تحكم Windows Forms برمجياً إلى أي مستند مفتوح في وقت التشغيل . أولاً، قم بإنشاء عنصر مضيف يستند إلى مستند مفتوح أو ورقة عمل مفتوحة . ثم في Word، استخدم الأساليب من الخاصية Document.Controls من العنصر المضيف الجديد . في Excel، استخدم الأساليب من الخاصية Worksheet.Controls من العنصر المضيف الجديد . يحتوي كل أسلوب على العديد من التحميلات الزائدة التي تتيح لك تحديد موقع عنصر التحكم بطرق مختلفة. لمزيد من المعلومات، راجع الأساليب المساعدة لعناصر تحكم Windows Forms.

عند إضافة عناصر تحكم Windows Forms إلى مستند في وقت التشغيل ، لا يظل عنصر التحكم في المستند عند إغلاق المستند. يمكنك إعادة إنشاء عنصر التحكم المرة التالية التي يتم فيها فتح المستند. لمزيد من المعلومات، راجع إضافة عناصر تحكم إلى مستندات Office في وقت التشغيل.

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

لإضافة أحد عناصر تحكم Windows Forms في وقت التشغيل

  • استخدم الأسلوب المسمى Add < فئة عنصر التحكم > (حيث فئة عنصر التحكم هو اسم فئة عناصر تحكم Windows Forms التي تريد إضافتها, مثل AddButton()).

    ملاحظة

    في الوظائف الإضافية على مستوى التطبيق التي تستهدف .NET Framework 4 ، يجب عليك إضافة مرجعية إلى تجميع Microsoft.Office.Tools.Excel.v4.0.Utilities.dll أو Microsoft.Office.Tools.Word.v4.0.Utilities.dll قبل أن يمكنك الوصول إلى أساليب Add < فئة عنصر التحكم > .

    يوضح مثال التعليمات البرمجية التالي كيفية إضافة Button إلى الفقرة الأولى من المستند النشط باستخدام الوظيفة الإضافية الخاصة بــ Word

    Dim salesButton As Microsoft.Office.Tools.Word.Controls.Button

' 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()

extendedDocument.Paragraphs(1).Range.InsertParagraphBefore()
salesButton = extendedDocument.Controls.AddButton( _
    extendedDocument.Paragraphs(1).Range, 75, 18, "salesButton")
salesButton.Text = "Calculate Sales"

    Microsoft.Office.Tools.Word.Controls.Button salesButton;

// 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();

extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
salesButton = extendedDocument.Controls.AddButton(
    extendedDocument.Paragraphs[1].Range, 75, 18, "salesButton");
salesButton.Text = "Calculate Sales";

راجع أيضًا:

المهام

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

المبادئ

نظرة عامة على عناصر تحكم Windows Forms فى مستندات Office

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

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

المعلمات الاختيارية في حلول Office