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

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

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

الأساليب المساعدة لـ Excel

لإضافة عناصر تحكم Windows Forms إلى ورقة عمل في وقت التشغيل، استخدم الأساليب المساعدة المتوفرة على الكائن ControlCollection الذي يتم إرجاعه بواسطة خاصية Worksheet.Controls (في مشروع على مستوى التطبيق) أو خاصية WorksheetBase.Controls (في مشروع على مستوى المستند). كل أسلوب مساعد محمل تحميلا زائدا بحيث يمكنك أن تمر فى Range أو الإحداثيات الخاصة بموقع معين. عند إنشاء عنصر تحكم بواسطة المرور في Range، يقوم عنصر التحكم تلقائياً بتغيير حجمه عندما يتم تغيير حجم الخلايا ضمن النطاق.

ملاحظة

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

يُبيّن الجدول التالي الأساليب المساعدة التي يمكنك استخدامها لتضيف برمجياً عناصر تحكم Windows Forms إلى مصنفات Excel.

الأسلوب المساعد	الوصف
AddButton(ControlCollection, Range, String)	يضيف عنصر تحكم Button إلى النطاق المحدد.
AddButton(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم Button في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddLabel(ControlCollection, Range, String)	يضيف عنصر تحكم Label إلى النطاق المحدد.
AddLabel(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم Label في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddLinkLabel(ControlCollection, Range, String)	يضيف عنصر تحكم LinkLabel إلى النطاق المحدد.
AddLinkLabel(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم LinkLabel في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddTextBox(ControlCollection, Range, String)	يضيف عنصر تحكم TextBox إلى النطاق المحدد.
AddTextBox(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم TextBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddCheckBox(ControlCollection, Range, String)	يضيف عنصر تحكم CheckBox إلى النطاق المحدد.
AddCheckBox(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم CheckBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddRadioButton(ControlCollection, Range, String)	يضيف عنصر تحكم RadioButton إلى النطاق المحدد.
AddRadioButton(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم RadioButton في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddPictureBox(ControlCollection, Range, String)	يضيف عنصر تحكم PictureBox إلى النطاق المحدد.
AddPictureBox(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم PictureBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddCheckedListBox(ControlCollection, Range, String)	يضيف عنصر تحكم CheckedListBox إلى النطاق المحدد.
AddCheckedListBox(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم CheckedListBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddComboBox(ControlCollection, Range, String)	يضيف عنصر تحكم ComboBox إلى النطاق المحدد.
AddComboBox(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم ComboBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddListView(ControlCollection, Range, String)	يضيف عنصر تحكم ListView إلى النطاق المعيّن إعدادًا لموضع وحجم عنصر التحكم.
AddListView(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم ListView في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddTreeView(ControlCollection, Range, String)	يضيف عنصر تحكم TreeView إلى النطاق المحدد.
AddTreeView(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم TreeView في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddDateTimePicker(ControlCollection, Range, String)	يضيف عنصر تحكم DateTimePicker إلى النطاق المحدد.
AddDateTimePicker(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم DateTimePicker في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddMonthCalendar(ControlCollection, Range, String)	يضيف عنصر تحكم MonthCalendar إلى النطاق المحدد.
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم MonthCalendar في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddDomainUpDown(ControlCollection, Range, String)	يضيف عنصر تحكم DomainUpDown إلى النطاق المحدد.
AddDomainUpDown(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم DomainUpDown في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddNumericUpDown(ControlCollection, Range, String)	يضيف عنصر تحكم NumericUpDown إلى النطاق المحدد.
AddNumericUpDown(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم NumericUpDown في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddTrackBar(ControlCollection, Range, String)	يضيف عنصر تحكم TrackBar إلى النطاق المحدد.
AddTrackBar(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم TrackBar في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddRichTextBox(ControlCollection, Range, String)	يضيف عنصر تحكم RichTextBox إلى النطاق المحدد.
AddRichTextBox(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم RichTextBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddDataGridView(ControlCollection, Range, String)	يضيف عنصر تحكم DataGridView إلى النطاق المحدد.
AddDataGridView(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم DataGridView في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddHScrollBar(ControlCollection, Range, String)	يضيف عنصر تحكم HScrollBar إلى النطاق المحدد.
AddHScrollBar(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم HScrollBar في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddVScrollBar(ControlCollection, Range, String)	يضيف عنصر تحكم VScrollBar إلى النطاق المحدد.
AddVScrollBar(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم VScrollBar في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddPropertyGrid(ControlCollection, Range, String)	يضيف عنصر تحكم PropertyGrid إلى النطاق المحدد.
AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم PropertyGrid في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddWebBrowser(ControlCollection, Range, String)	يضيف عنصر تحكم WebBrowser إلى النطاق المحدد.
AddWebBrowser(ControlCollection, Double, Double, Double, Double, String)	يضيف عنصر تحكم WebBrowser في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.

الأساليب المساعدة لـ Word

لإضافة عناصر تحكم Windows Forms إلى مستند في وقت التشغيل، استخدم الأساليب المساعدة المتوفرة على الكائن ControlCollection الذي يتم إرجاعه بواسطة خاصية Document.Controls (في مشروع على مستوى التطبيق) أو خاصية DocumentBase.Controls (في مشروع على مستوى المستند). كل أسلوب مساعد محمل تحميلا زائدا بحيث يمكنك أن تمر في Range أو الإحداثيات الخاصة بموقع معين. عند إنشاء عنصر تحكم بواسطة المرور في Range، تتم إضافة عنصر التحكم على أنه InlineShape في بداية النطاق. لا يمكنك تغيير الخصائص Top و Left لعناصر التحكم التي في نفس سطر نص. عند إنشاء عنصر تحكم بواسطة المرور في إحداثيات، تتم إضافة عنصر التحكم على أنه Shape عائم في الموقع المحدد.

ملاحظة

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

يُبيّن الجدول التالي الأساليب المساعدة التي يمكنك استخدامها لتضيف برمجياً عناصر تحكم Windows Forms إلى مستندات Word.

الأسلوب المساعد	الوصف
AddButton(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم Button في بداية النطاق المحدد.
AddButton(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم Button في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddLabel(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم Label في بداية النطاق المحدد.
AddLabel(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم Label في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddLinkLabel(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم LinkLabel في بداية النطاق المحدد.
AddLinkLabel(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم LinkLabel في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddTextBox(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم TextBox في بداية النطاق المحدد.
AddTextBox(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم TextBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddCheckBox(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم CheckBox في بداية النطاق المحدد.
AddCheckBox(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم CheckBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddRadioButton(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم RadioButton في بداية النطاق المحدد.
AddRadioButton(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم RadioButton في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddPictureBox(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم PictureBox في بداية النطاق المحدد.
AddPictureBox(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم PictureBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddCheckedListBox(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم CheckedListBox في بداية النطاق المحدد.
AddCheckedListBox(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم CheckedListBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddComboBox(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم ComboBox في بداية النطاق المحدد.
AddComboBox(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم ComboBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddListView(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم ListView إلى النطاق المعيّن إعدادًا لموضع وحجم عنصر التحكم.
AddListView(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم ListView في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddTreeView(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم TreeView في بداية النطاق المحدد.
AddTreeView(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم TreeView في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddDateTimePicker(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم DateTimePicker في بداية النطاق المحدد.
AddDateTimePicker(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم DateTimePicker في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddMonthCalendar(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم MonthCalendar في بداية النطاق المحدد.
AddMonthCalendar(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم MonthCalendar في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddDomainUpDown(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم DomainUpDown في بداية النطاق المحدد.
AddDomainUpDown(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم DomainUpDown في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddNumericUpDown(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم NumericUpDown في بداية النطاق المحدد.
AddNumericUpDown(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم NumericUpDown في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddTrackBar(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم TrackBar في بداية النطاق المحدد.
AddTrackBar(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم TrackBar في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddRichTextBox(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم RichTextBox في بداية النطاق المحدد.
AddRichTextBox(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم RichTextBox في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddDataGridView(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم DataGridView في بداية النطاق المحدد.
AddDataGridView(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم DataGridView في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddHScrollBar(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم HScrollBar في بداية النطاق المحدد.
AddHScrollBar(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم HScrollBar في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddVScrollBar(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم VScrollBar في بداية النطاق المحدد.
AddVScrollBar(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم VScrollBar في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddPropertyGrid(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم PropertyGrid في بداية النطاق المحدد.
AddPropertyGrid(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم PropertyGrid في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.
AddWebBrowser(ControlCollection, Range, Single, Single, String)	يضيف عنصر تحكم WebBrowser في بداية النطاق المحدد.
AddWebBrowser(ControlCollection, Single, Single, Single, Single, String)	يضيف عنصر تحكم WebBrowser في الموضع المحدد بدلاً من نطاق. يتم تمثيل الإحداثيات بالنقاط.

راجع أيضًا:

المبادئ

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

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

قيود عناصر تحكم Windows Forms على مستندات Office

موارد أخرى

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