الإرشادات التفصيلية: تجميع البيانات باستخدام Windows Form

مقالة
11/01/2010

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

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

نوع المشروع

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

إصدار Microsoft Office

نظام 2007 Microsoft Office
Microsoft Office 2010

توضح هذه الإرشادات التفصيلية كيفية فتح Windows Form من تخصيص على مستوى المستند لـ Microsoft Office Excel ، و تجميع المعلومات من المستخدم ، و كتابة تلك المعلومات في خلية ورقة عمل .

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

المتطلبات الأساسية

تحتاج إلى المكونات التالية لاستكمال هذه الإرشادات التفصيلية:

إصدار لـ Visual Studio 2010 يشمل أدوات مطوري Microsoft Office. لمزيد من المعلومات، راجع [تكوين كمبيوتر لتطوير حلول Office](bb398242\(v=vs.100\).md).

Microsoft Office Excel 2007 أو Excel 2010.

ملاحظة

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

إنشاء مشروع جديد

الخطوة الأولى هي إنشاء مشروع مصنف Excel.

لإنشاء أحد المشروعات الجديدة

Create an Excel Workbook project with the name WinFormInput, and select Create a new document in the wizard. لمزيد من المعلومات، راجع كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio.

يقوم Visual Studio بفتح مصنف Excel جديد في المصمم ثم يقوم بإضافة المشروع MWinFormInput إلى مستكشف الحلول.

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

لإضافة نطاق مسمى إلى الورقة1 (Sheet1)

حدد الخلية A1 على Sheet1.
In the Name box, type formInput.

يقع المربع الاسم على يسار شريط الصيغة أعلى العمود A في ورقة العمل.
اضغط ENTER.

يتم إضافة عنصر التحكم NamedRange إلى الخلية A1. لا توجد إشارة مرئية على ورقة العمل ولكن يظهر formInput في المربع الاسم (أعلى ورقة العمل على الجانب الأيسر) و في النافذة خصائص عند تحديد الخلية A1.

إضافة Windows Form إلى المشروع

إنشاء Windows Form لمطالبة المستخدم بالمعلومات.

لإضافة Windows Form

في مستكشف الحلول ،حدد المشروعWinFormInput .
في القائمة مشروع انقر فوق إضافة Windows Form .
قم بتسمية النموذج GetInputString.vb أو GetInputString.cs ثم انقر فوق إضافة .

يتم فتح النموذج الجديد في المصمم.
قم بإضافةTextBox و Button إلى النموذج.
حدد الزر, ابحث عن الخاصية نص (Text) في النافذة خصائص و قم بتغيير النص إلى موافق .

ثم بعد ذلك، قم بإضافة التعليمات البرمجية ThisWorkbook.vb أو ThisWorkbook.cs لجمع معلومات المستخدم.

عرض Windows Form و تجميع المعلومات

قم بإنشاء مثيل Windows Form GetInputString و عرضه ثم ثم كتابة معلومات المستخدم في خلية في ورقة العمل.

لعرض النموذج و تجميع المعلومات

في مستكشف الحلول، انقر بزر الماوس الأيمن فوق ThisWorkbook.vb أو ThisWorkbook.cs ومن ثم انقر فوق عرض التعليمات البرمجية.
في معالج الحدث Open من ThisWorkbook ، قم بإضافة التعليمة البرمجية التالية لتعريف متغير للنموذج GetInputStringثم أظهر النموذج.

ملاحظة

في C# ، يجب عليك إضافة معالج أحداث كما هو موضح في الحدث Startup أدناه. للحصول على معلومات حول إنشاء معالجات أحداث راجع كيفية القيام بما يلي: إنشاء معالجات أحداث في مشاريع Office.
```
Private Sub ThisWorkbook_Open() Handles Me.Open
    Dim inputForm As New GetInputString()
    inputForm.Show()
End Sub
```
```
private void ThisWorkbook_Startup(object sender, System.EventArgs e)
{
    this.Open += new 
        Microsoft.Office.Interop.Excel.WorkbookEvents_OpenEventHandler(ThisWorkbook_Open);
}

private void ThisWorkbook_Open()
{
    GetInputString inputForm = new GetInputString();
    inputForm.Show();
}
```
قم بإنشاء أسلوب يسمى WriteStringToCell يكتب النص إلى نطاق مسمى. يتم استدعاء هذا الأسلوب من النموذج ثم يتم تمرير مدخلات المستخدم إلى عنصر التحكم NamedRange ، formInput، على الخلية A1
```
Public Sub WriteStringToCell(ByVal formData As String)
    Globals.Sheet1.formInput.Value2 = formData
End Sub
```
```
public void WriteStringToCell(string formData)
{
    Globals.Sheet1.formInput.Value2 = formData;
}
```

بعد ذلك ، قم بإضافة تعليمة برمجية إلى النموذج لمعالجة حدث النقر الخاص بالزر .

إرسال المعلومات إلى ورقة العمل

لإرسال المعلومات إلى ورقة العمل

في مستكشف الحلول ، انقر بزر الماوس الأيمن فوق GetInputString ثم انقر فوق عرض المصمم.
انقر نقراً مزدوجاً فوق الزر لفتح ملف التعليمات البرمجية بمعالج أحداث Click المضاف الخاص بالزر .
قم بإضافة التعليمات البرمجية إلى معالج الأحداث لأخذ الإدخال من مربع النص، إرساله إلى الدالة WriteStringToCell ، ثم إغلاق النموذج.
```
Globals.ThisWorkbook.WriteStringToCell(Me.TextBox1.Text)
Me.Dispose()
```
```
Globals.ThisWorkbook.WriteStringToCell(this.textBox1.Text);
this.Dispose();
```

الاختبار

يمكنك الآن تشغيل المشروع. سيظهر Windows Form ويظهر الإدخال الخاص بك في ورقة العمل.

لاختبار المصنف الخاص بك

اضغط F5 لتشغيل مشروعك.
تحقق من ظهور Windows Form.
Type Hello World in the text box, and then click OK.
Confirm that Hello World appears in cell A1 of the worksheet.

الخطوات التالية

تُظهر هذه الإرشادات التفصيلية أساسيات إظهار Windows Form و تمرير البيانات إلى ورقة عمل. مهام أخرى قد تحتاج أن تنفَّذها تتضمن:

استخدم عناصر تحكم Windows Forms على مصنف Excel أو مستند Word . لمزيد من المعلومات، راجع نظرة عامة على عناصر تحكم Windows Forms فى مستندات Office.
Modify the user interface of a Microsoft Office application from a document-level customization or an application-level add-in. لمزيد من المعلومات، راجع تخصيص واجهة Office.

راجع أيضًا:

مشاركة عبر