مشاركة عبر

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

  • مقالة

ينطبق على

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

نوع المشروع

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

إصدار Microsoft Office

  • Excel 2007

  • Excel 2010

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

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

  • إنشاء وظيفة Excel إضافية فى مشروع لـ Excel.

  • كتابة تعليمات برمجية تستخدم نموذج كائن من 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. في المربع الاسم، اكتب FirstExcelAddIn‎.

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

    ينشئ المشروع FirstExcelAddIn و يفتح ملف التعليمات البرمجية ThisAddIn في المحرر.

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

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

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

  • معالجا الأحداث ThisAddIn_Startup وThisAddIn_Shutdown. لتشغيل إضافة-زر 'Ins' التي تم إنشاؤها باستخدام أدوات تطوير المكتب في ‏‫Visual Studio، يجب أن يكون لأجهزة الكمبيوتر للمستخدم النهائي في مثبتة. وقت التشغيل يتضمن المكونات غير مدار ومجموعة من تجميعات المدارة. استخدام هذه معالجات الأحداث يهيّئ الوظيفة الإضافية عند هو تم تحميله، ولتنظيف موارد المستخدمة من قبل الوظيفة الإضافية عند هو غير محمل. لمزيد من المعلومات، راجع الأحداث في مشاريع Office.

لإضافة سطر من النص إلى المصنف المحفوظ

  1. في ملف التعليمات البرمجية ThisAddIn ، قم بإضافة التعليمة البرمجية التالية للفئة ThisAddIn تعرف التعليمات البرمجية الجديدة معالج الأحداث للحدث WorkbookBeforeSave الذي يتم رفعه عند حفظ. المصنف

    عندما يحفظ المستخدم المصنف ، يضيف معالج الأحداث النص الجديد في بداية ورقة العمل النشطة.

    Private Sub Application_WorkbookBeforeSave(ByVal Wb As Microsoft.Office.Interop.Excel.Workbook, ByVal SaveAsUI As Boolean, ByRef Cancel As Boolean) Handles Application.WorkbookBeforeSave
    Dim activeWorksheet As Excel.Worksheet = CType(Application.ActiveSheet, Excel.Worksheet)
    Dim firstRow As Excel.Range = activeWorksheet.Range("A1")
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown)
    Dim newFirstRow As Excel.Range = activeWorksheet.Range("A1")
    newFirstRow.Value2 = "This text was added by using code"
End Sub

    void Application_WorkbookBeforeSave(Microsoft.Office.Interop.Excel.Workbook Wb, bool SaveAsUI, ref bool Cancel)
{
    Excel.Worksheet activeWorksheet = ((Excel.Worksheet)Application.ActiveSheet);
    Excel.Range firstRow = activeWorksheet.get_Range("A1", missing);
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown, System.Type.Missing);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1", missing);
    newFirstRow.Value2 = "This text was added by using code";
}

  2. إذا كنت تستخدم C# ، أضف التعليمة البرمجية التالية إلى معالج الحدث ThisAddIn_Startup . هذه التعليمات البرمجية مطلوبة لاستدعاء معالج الأحداث Application_WorkbookBeforeSave مع الحدث WorkbookBeforeSave .

    this.Application.WorkbookBeforeSave += new Microsoft.Office.Interop.Excel.AppEvents_WorkbookBeforeSaveEventHandler(Application_WorkbookBeforeSave);

لتعديل المصنف عند حفظه ,أمثلة التعليمات البرمجية السابقة تستخدم الكائنات التالية:

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

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

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

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

  2. في Excel، احفظ المصنف.

  3. تحقق من إضافة النص التالي إلى المصنف.

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

  4. قم بإغلاق Excel.

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

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

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

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

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

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

راجع أيضًا:

المبادئ

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

موارد أخرى

حلول Excel

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

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

تخصيص واجهة Office

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

توزيع حلول Office

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