ملاحظة: يتم تعطيل الدالة أو الأسلوب أو الكائن أو الخاصية الموضحة في هذا الموضوع إذا كانت خدمة تعبير Microsoft Jet قيد التشغيل في وضع بيئة الاختبار المعزولة، مما يمنع تقييم التعبيرات التي يحتمل أن تكون غير آمنة. لمزيد من المعلومات حول وضع بيئة الاختبار المعزولة، ابحث عن "وضع بيئة الاختبار المعزولة" في التعليمات.
يقوم بتشغيل برنامج قابل للتنفيذ وإرجاع متغير (مزدوج) يمثل معرف مهمة البرنامج إذا كان ناجحا، وإلا فإنه يرجع صفرا.
بناء الجملة
Shell( pathname [, windowstyle ] )
يحتوي بناء جملة الدالة Shell على هذه الوسيطات:
|
الوسيطة |
الوصف |
|
Pathname |
مطلوبة. متغير (سلسلة). اسم البرنامج المطلوب تنفيذه وأي وسيطات أو مفاتيح تبديل سطر الأوامر مطلوبة؛ قد يتضمن الدليل أو المجلد ومحرك الأقراص. في Macintosh، يمكنك استخدام الدالة MacID لتحديد توقيع تطبيق بدلا من اسمه. يستخدم المثال التالي توقيع Microsoft Word: Shell MacID("MSWD") |
|
windowstyle |
اختيارية. المتغير (عدد صحيح) المطابق لنمط النافذة التي سيتم تشغيل البرنامج فيها. إذا تم حذف windowstyle ، يتم بدء تشغيل البرنامج مع التركيز. على Macintosh (النظام 7.0 أو أحدث)، يحدد windowstyle فقط ما إذا كان التطبيق يحصل على التركيز عند تشغيله أم لا. |
تحتوي الوسيطة المسماة windowstyle على هذه القيم:
|
ثابت |
قيمة |
الوصف |
|
vbHide |
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)
