الإرشادات التفصيلية: إنشاء التخصيص الأول الخاص بك على مستوى المستند لـ Excel

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

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

توضح هذه الإرشادات التفصيلية المهام التالية:

• إنشاء مشروع مصنف Excel

• إضافة نص إلى ورقة عمل تتم استضافتها في مصمم Visual Studio.

• كتابة تعليمات برمجية تستخدم نموذج كائن من Excel لإضافة النص إلى ورقة عمل مخصصة عند فتحه.

• بناء و تشغيل المشروع لاختباره.

• تنظيف المشاريع المكتملة لإزالة ملفات البناء غير الضرورية وإعدادات الأمان من كمبيوتر التطوير الخاص بك.

ملاحظة

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

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

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

-

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

• Microsoft Office Excel 2007 أو Excel 2010.

إنشاء المشروع

لإنشاء مشروع مصنف Excel جديد في Visual Studio

1. ابدأ Visual Studio.

2. من القائمة File (ملف)، أشر إلى New (جديد)، ثم انقر فوق Project (مشروع).

3. في جزء القوالب، قم بتوسيع #Visual C أو Visual Basic ثم قم بتوسيع Office.

4. ضمن العقدة الموسعة Office، حدد 2007 إذا كان لديك Excel 2007 مثبت، أو حدد العقدة 2010 إذا كان لديك Excel 2010 مثبتا.

5. في قائمة قوالب المشروع، حدد مصنف Excel 2007 أو مصنف Excel 2010.

6. في مربع الاسم، اكتب FirstWorkbookCustomization.

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

   أدوات Visual Studio لمعالج مشروع Office تفتح.

8. حدد إنشاء مستند جديد، وانقر فوق موافق.

   • ينشئ Visual Studio المشروع FirstWorkbookCustomization، ويقوم بإضافة الملفات التالية إلى المشروع.

   • FirstWorkbookCustomization - .xlsxيمثل مصنف Excel في المشروع. يحتوي على كافة أوراق العمل والتخطيطات.

   • Sheet1 (ملف .vb لـ Visual Basic أو ملف .cs لـ#Visual C) - ورقة عمل توفر سطح التصميم والتعليمات البرمجية لورقة العمل الأولى في المصنف. لمزيد من المعلومات، راجع عنصر مضيف خاص بورقة عمل.

   • Sheet2 (ملف .vb لـ Visual Basic أو ملف .cs لـ#Visual C) - ورقة عمل توفر سطح التصميم والتعليمات البرمجية لورقة العمل الثانية في المصنف.

   • Sheet3 (ملف .vb لـ Visual Basic أو ملف .cs لـ#Visual C) - ورقة عمل توفر سطح التصميم والتعليمات البرمجية لورقة العمل الثالثة في المصنف.

   • ThisWorkbook (ملف .vb لـ Visual Basic أو ملف .cs لـ#Visual C) - يتضمن سطح التصميم والتعليمات البرمجية للتخصيصات على مستوى المصنف. لمزيد من المعلومات، راجع عنصر مضيف المصنف.

   يتم فتح ملف التعليمات البرمجية Sheet1 تلقائيًا في المصمم.

إغلاق وإعادة فتح أوراق العمل في المصمم

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

لإغلاق ثم إعادة فتح ورقة عمل ما في المصمم

1. قم بإغلاق المصنف عن طريق النقر فوق زر إغلاق(X لنافذة المصمم.

2. في مستكشف الحلول، انقر برز الماوس الأيمن فوق ملف التعليمات البرمجية Sheet1، ثم انقر فوق عرض المصمم.

   -أو-

   في مستكشف الحلول، ‏‫انقر نقرًا مزدوجًا علي ملف التعليمات البرمجية Sheet1.

إضافة نص إلى ورقة عمل في المصمم

يمكنك تصميم واجهة المستخدم للتخصيص الخاص بك عن طريق تعديل ورقة العمل المفتوحة في المصمم. على سبيل المثال، يمكنك إضافة نص إلى خلايا، أو تطبيق صيغ، أو إضافة عناصر تحكم Excel. للمزيد من المعلومات حول كيفية استخدام المصمم، راجع مشاريع Office في بيئة Visual Studio.

لإضافة نص إلى ورقة عمل باستخدام المصمم

• في ورقة العمل المفتوحة في المصمم، حدد الخلية A1، ومن ثم اكتب النص التالي.

  هذا النص تمت إضافته باستخدام المصمم.

تنبيه
إذا قمت بإضافة هذا السطر من النص إلى الخلية A2، فإنه سيتم الكتابة فوقها بواسطة تعليمات برمجية أخرى في هذا المثال.

إضافة نص إلى ورقة عمل برمجيًا

بعد ذلك، قم بإضافة التعليمات البرمجية إلى ملف التعليمات البرمجية Sheet1. تستخدم التعليمات البرمجية الجديدة نموذج كائن Excel لإضافة سطر ثانٍ من النص إلى المصنف. افتراضيًا، ملف التعليمات البرمجية Sheet1 يحتوي على التعليمات البرمجية المنشأة التالية:

• تعريف جزئي للفئة Sheet1، التي تمثل النموذج البرمجي لورقة العمل وتوفر الاتصال بنموذج كائن Excel. لمزيد من المعلومات، راجع عنصر مضيف خاص بورقة عمل ونظرة عامة على نموذج كائن Word. باقي فئة Sheet1 تم تعريفها في ملف التعليمات البرمجية المخفي الذي يجب عليك ألا تقوم بتعديله.

• معالجا الأحداث Sheet1_Startup وSheet1_Shutdown. معالجا الأحداث هذان يتم استدعاؤهما عند تحميل Excel وإلغاء تحميل التخصيص الخاص بك. قم باستخدام معالجي الأحداث هذين لتهيئة التخصيص الخاص بك عند تحميله، ولتنظيف الموارد المستخدمة من قبل التخصيص الخاص بك عند إلغاء تحميل. لمزيد من المعلومات، راجع الأحداث في مشاريع Office.

لإضافة سطر ثانٍ من نص إلى ورقة العمل باستخدام تعليمات برمجية

1. في مستكشف الحلول، انقر بزر الماوس الأيمن فوق Sheet1، ثم انقر فوق عرض التعليمات البرمجية.

   يتم فتح ملف التعليمات البرمجية في Visual Studio.

2. قم باستبدال معالج الأحداث Sheet1_Startup بالتعليمات البرمجية التالية. عند فتح Sheet1، تقوم هذه التعليمات البرمجية بإضافة سطر ثانٍ من النص إلى ورقة العمل.

   Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
       Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
           Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
       nr.Value2 = "This text was added by using code"
   End Sub
   

   private void Sheet1_Startup(object sender, System.EventArgs e)
   {
       Microsoft.Office.Tools.Excel.NamedRange nr =
           this.Controls.AddNamedRange(this.Range["A2", missing], "NamedRange1");
       nr.Value2 = "This text was added by using code";
   }
   

اختبار المشروع

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

1. اضغط F5 لبناء المشروع وتشغيله.

   عند بناء المشروع، تتم ترجمة التعليمات البرمجية إلى تجميع مقترن بالمصنف. يضع Visual Studio نسخة من المصنف ثم التجميع في مجلد إخراج البناء للمشروع، ثم يقوم بتكوين إعدادات الأمان على كمبيوتر التطوير لتمكين التخصيص من التشغيل. لمزيد من المعلومات، راجع نظرة عامة حول عملية بناء حل Office.

2. في المصنف، تأكد من رؤية النص التالي.

   هذا النص تمت إضافته باستخدام المصمم.

   تمت إضافة هذا النص باستخدام تعليمات برمجية (This text was added by using code).

3. قم بإغلاق المصنف.

تنظيف المشروع

عند الانتهاء من تطوير مشروع ما، يجب إزالة الملفات الموجودة في مجلد إخراج البناء وإعدادات الأمان التي تم إنشاؤها بواسطة عملية البناء.

لتنظيف المشاريع المكتملة على كمبيوتر التطوير الخاص بك

• في Visual Studio على القائمة بناء ، انقر فوق ‎تنظيف الحل.

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

والآن بعد أن قمت بإنشاء تخصيص أساسي على مستوى المستند لـ Excel، يمكنك معرفة المزيد حول كيفية تطوير تخصيصات من هذه المواضيع:

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

• مهام البرمجة المحددة إلى تخصيصات على مستوى المستند لـ Excel: حلول Excel.

• استخدام نموذج الكائن لـ Excel. ‏‫نظرة عامة لنموذج كائن Excel.

• تخصيص واجهة المستخدم لـ Excel، على سبيل المثال، بإضافة علامة تبويب مخصصة للشريط أو إنشاء جزء الإجراءات الخاص بك: تخصيص واجهة Office.

• استخدام كائنات Excel موسعة تم توفيرها من قبل أدوات تطوير Office في Visual Studio لتنفيذ مهام ليست ممكنة باستخدام نموذج كائن Excel (على سبيل المثال، استضافة عناصر تحكم مدارة على مستندات وربط عناصر تحكم Excel بالبيانات باستخدام نموذج ربط بيانات Windows Forms): أتمتة Excel عن طريق استخدام الكائنات الموسعة.

• بناء وتصحيح أخطاء تخصيصات على مستوى المستند لـ Excel: بناء وتصحيح أخطاء حلول Office.

• نشر تخصيصات على مستوى المستند لـ Excel: توزيع حلول Office.

راجع أيضًا:

المبادئ

نظرة عامة حول تطوير حلول Office

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

موارد أخرى

حلول Excel

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

‏‫نظرة عامة لنموذج كائن Excel

تخصيص واجهة Office

بناء وتصحيح أخطاء حلول Office

توزيع حلول Office

نظرة عامة حول قوالب مشاريع Office