ملاحظة
يتم تعطيل الوظيفة أو الطريقة أو العنصر أو الخاصية الموضحة في هذا الموضوع إذا كانت خدمة Microsoft Jet Expression Service قيد التشغيل في وضع الحماية، مما يمنع تقييم التعبيرات التي يحتمل أن تكون غير آمنة. لمزيد من المعلومات حول وضع الحماية، ابحث عن "وضع الحماية" في "تعليمات".
تشغل برنامجا تنفيذيا وترجع متغيرا (مزدوجا) يمثل معرف مهمة البرنامج في حالة نجاحه، وبخلاف ذلك يرجع صفرا.
بناء الجملة
Shell(pathname [, windowstyle ] )
يحتوي بناء جملة الدالة Shell على الوسيطات التالية:
| الوسيطة | الوصف |
|---|---|
| اسم المسار | مطلوبة.
المتغير (سلسلة). اسم البرنامج المطلوب تنفيذه وأي وسيطات مطلوبة أو مفاتيح تبديل سطر الأوامر؛ قد تتضمن دليلا أو مجلدا ومحرك أقراص. في Macintosh، يمكنك استخدام الدالة MacID لتحديد توقيع تطبيق بدلا من اسمه. يستخدم المثال التالي التوقيع الخاص ب Microsoft Word:Shell MacID("MSWD") |
| نمط نافذة | اختيارية. متغير (عدد صحيح) مطابق لنمط النافذة التي سيتم تشغيل البرنامج فيها. إذا تم حذف نمط النافذة ، يتم تشغيل البرنامج بصورة مصغرة مع التركيز. في Macintosh (النظام 7.0 أو إصدار أحدث) ، يحدد windowstyle فقط ما إذا كان التطبيق يحصل على التركيز عند تشغيله أم لا. |
تحتوي الوسيطة المسماة بنمط النافذة على هذه القيم:
| القيمة الثابتة | Value | الوصف |
|---|---|---|
| vbإخفاء | 0 | يتم إخفاء النافذة ويتم نقل التركيز إلى النافذة المخفية. لا ينطبق ثابت vbHide على الأنظمة الأساسية Macintosh. |
| vbNormalFocus | 1 | تحتوي النافذة على تركيز ويتم إعادتها إلى حجمها وموضعها الأصلي. |
| vbMinimizedFocus | 2 | يتم عرض النافذة كأيقونة مع التركيز. |
| vbMaximizedFocus | 3 | يتم تكبير النافذة مع التركيز. |
| vbNormalNoFocus | 4 | تتم استعادة النافذة إلى أحدث حجم ومواضع لها. تظل النافذة النشطة حاليا نشطة. |
| vbMinimizedNoFocus | 6 | يتم عرض النافذة كأيقونة. تظل النافذة النشطة حاليا نشطة. |
ملاحظات
إذا نجحت دالة Shell في تنفيذ الملف المسمى، فإنها ترجع معرف المهمة للبرنامج الذي بدأه. معرف المهمة هو رقم فريد يحدد البرنامج قيد التشغيل. إذا تعذر على دالة Shell بدء تشغيل البرنامج المسمى، يحدث خطأ.
على Macintosh ، يضع vbNormalFocus و vbMinimizedFocus و vbMaximizedFocus التطبيق في المقدمة. vbHide و vbNoFocus و vbMinimizeFocus كلها تضع التطبيق في الخلفية.
ملاحظة
بشكل افتراضي، تقوم الدالة Shell بتشغيل برامج أخرى بشكل غير متزامن. وهذا يعني أن البرنامج الذي بدأ ب Shell قد لا ينتهي من التنفيذ قبل تنفيذ العبارات التي تلي الدالة Shell .
مثال
ملاحظة
توضح الأمثلة التالية استخدام هذه الدالة في وحدة نمطية ل Visual Basic for Applications (VBA). لمزيد من المعلومات حول استخدام VBA، حدد "مرجع المطور" في القائمة المنسدلة بجوار "بحث" وأدخل مصطلح أو أكثر في مربع البحث.
يستخدم هذا المثال الدالة Shell لتشغيل تطبيق يحدده المستخدم. في MacIntosh، يكون اسم محرك الأقراص الافتراضي هو "HD" ويتم فصل أجزاء من اسم المسار بنقطتين بدلا من الشرط العكسية. وبشكل مماثل، يمكنك تحديد مجلدات Macintosh بدلا من \Windows.
' Specifying 1 as the second argument
' opens the application in normal size and
' gives it the focus.
Dim RetVal
' Run Calculator.
RetVal = Shell("C:\WINDOWS\CALC.EXE", 1)