مشاركة عبر

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

  • مقالة

ينطبق على

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

نوع المشروع

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

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

إصدار Microsoft Office

  • نظام 2007 Microsoft Office

  • Microsoft Office 2010

العديد من الأساليب في نماذج الكائن بتطبيقات Microsoft Office تقبل معلمات اختيارية. إذا كنت تستخدم Visual Basic لتطوير حل Office في Visual Studio 2010 ، ليس من الضروري تمرير قيمة لمعلمة اختيارية لأن القيم الافتراضية يتم استخدامها تلقائياً لكل معلمة مفقودة . في معظم الحالات، يمكنك أيضاً حذف المعلمات الاختيارية في مشاريع Visual C#. ومع ذلك، لا يمكنك حذف معلمة ref الاختياري من فئة ThisDocument في مشاريع Word مستوى المستند.

للحصول على مزيد من المعلومات حول العمل مع المعلمات الاختيارية في مشاريع Visual C# و Visual Basic راجع وسيطات مسماة واختياري (C# البرمجة الدليل) و معلمات اختيارية.

ملاحظة

في الإصدارات السابقة من Visual Studio ، يجب أن تمرر قيمة كل معلمة اختيارية في مشاريع Visual C# . للتسهيل ، تتضمن هذه المشاريع متغير عمومي باسم missing التي يمكنك تمريره إلى معلمة اختيارية عندما تريد استخدام القيمة الافتراضية للمعلمة. مشاريع #Visual C لـ Office في Visual Studio 2010 لا تزال تتضمن متغيرmissing ، ولكن عادةً لا تحتاج إلى استخدام ذلك عند تطوير حلول Office في Visual Studio 2010 ، فيما عدا عند استدعاء الأساليب ذات المعلمات ref الاختيارية في الفئة ThisDocument في المشاريع التى على مستوى المستند لـ Word.

المثال في Excel

أسلوب Worksheet.CheckSpelling يحتوي العديد من المعلمات الاختيارية. يمكنك تحديد قيم لبعض المعلمات و قبول القيمة الافتراضية للآخرين كما هو موضح في المثال التالي من التعليمات البرمجية. يتطلب هذا المثال مشروع على مستوى المستند بفئة ورقة عمل تسمى Sheet1.

Globals.Sheet1.CheckSpelling(ignoreUppercase:=True)

// In projects that target the .NET Framework 3.5, change "ignoreUppercase" to "IgnoreUppercase" 
// in the previous line of code.
Globals.Sheet1.CheckSpelling(ignoreUppercase: true);

المثال في Word

أسلوب Find.Execute يحتوي العديد من المعلمات الاختيارية. يمكنك تحديد قيم لبعض المعلمات و قبول القيمة الافتراضية للآخرين كما هو موضح في المثال التالي من التعليمات البرمجية.

With Me.Application.ActiveDocument.Content
    .Find.ClearFormatting()
    .Find.Execute(FindText:="blue", ReplaceWith:="red", Replace:=Word.WdReplace.wdReplaceAll)
End With

Word.Range documentRange = this.Application.ActiveDocument.Content;
documentRange.Find.ClearFormatting();
documentRange.Find.Execute(FindText: "blue", ReplaceWith: "red", Replace: Word.WdReplace.wdReplaceAll);

استخدام المعلمات الاختيارية وظائف في هذه الفئة مستند في Visual C# مستند-المستوى المشاريع الخاصة ب الكلمة

نموذج كائن Word يحتوي على العديد من الأساليب بمعلماتref اختيارية تقبل قيم من نوع Object . ومع ذلك، لا يمكن حذف اختياري refالمعلمات للأساليب الخاصة المنشأ ThisDocumentفئة في Visual C# مشاريع المستوى مستند الكلمة. #Visual C يمكّنك من حذف معلمات ref اختيارية فقط من أجل أساليب الواجهات لا الفئات. ما يلي على سبيل المثال، تعليمات برمجية المثال ليس ترجمة، لأنه لا يمكن حذف اختيارية refمعلمات CheckSpellingأسلوب ThisDocumentفئة.

Globals.ThisDocument.CheckSpelling(ignoreUppercase: true);

عند استدعاء أساليب الفئة ThisDocument ، اتبع هذه الإرشادات:

  • لقبول القيمة الافتراضية لمعلمة ref الاختياري ، قم بتمرير المتغير missing إلى المعلمة. المتغير missing يتم تعريفه تلقائياً في مشاريع Visual C# Office كما تم تعيينه إلى القيمة "Type.Missing في" التعليمات البرمجية التي تم إنشاؤها في المشروع.

  • لتعيين القيمة الخاصة بك لمعلمة ref الاختيارية , قم بتعريف كائن تم تعيينه إلى القيمة التي تريد تحديدها ومن ثم قم بتمرير الكائن إلى المعلمة.

يوضح مثال التعليمة البرمجية التالية كيف إلى استدعاء CheckSpellingالأسلوب بتعيين القيمة من أجل ignoreUppercaseمعلمة وقبول القيمة افتراضية للأخرى معلمات.

object ignoreUppercase = true;
Globals.ThisDocument.CheckSpelling(
    ref missing, ref ignoreUppercase, ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing, ref missing, ref missing);

إذا كنت تريد كتابة التعليمات البرمجية التي تقوم بحذف معلمات ref الاختيارية لأسلوب في الفئة ThisDocument ، يمكنك بدلاً من ذلك استدعاء نفس الأسلوب بالكائن Microsoft.Office.Interop.Word.Document الذى تم إرجاعه بواسطة الخاصية InnerObject، ثم تحذف المعلمات من هذا الأسلوب. يمكنك القيام بذلك لأنه Microsoft.Office.Interop.Word.Documentهو واجهة، وليس فئة.

Globals.ThisDocument.InnerObject.CheckSpelling(IgnoreUppercase: true);

للحصول على مزيد من المعلومات حول قيمة و نوع مرجع المعلمات، راجع وسيطات التمرير حسب القيمة وعن طريق المرجع (لـ Visual Basic) ثم تمرير معلمات (C# البرمجة الدليل).

راجع أيضًا:

المبادئ

كتابة التعليمات البرمجية في حلول Office

موارد أخرى

تطوير حلول Office