הערה
הפונקציה, פעולת השירות, האובייקט או המאפיין המתוארים בנושא זה אינם זמינים אם Microsoft Jet Expression Service פועל במצב ארגז חול (Sandbox), דבר שמונע הערכה של ביטויים שעלולים להיות לא בטוחים. לקבלת מידע נוסף על מצב ארגז חול, חפש "מצב ארגז חול" בעזרה.
הפעלת תוכנית הפעלה והחזרת משתנה (כפול) המייצג את מזהה המשימה של התוכנית במידה והיא מצליחה, אחרת היא מחזירה אפס.
תחביר
Shell(pathname [, windowstyle ] )
תחביר הפונקציה Shell מכיל את הארגומנטים הבאים:
| ארגומנט | תיאור |
|---|---|
| שם נתיב | נדרש.
משתנה (מחרוזת). שם התוכנית לביצוע וכל הארגומנטים או מתגי שורת הפקודה הנדרשים; עשוי לכלול ספרייה או תיקיה וכונן. ב- Macintosh, באפשרותך להשתמש בפונקציה MacID כדי לציין חתימה של יישום במקום שמו. הדוגמה הבאה משתמשת בחתימה עבור Microsoft Word:Shell MacID("MSWD") |
| סגנון חלון | אופציונלי. משתנה (מספר שלם) המתאים לסגנון החלון שבו יש להפעיל את התוכנית. אם windowstyle מושמט, התוכנית מופעלת בצורה ממוזערת עם המיקוד. ב- Macintosh (System 7.0 ואילך), windowstyle קובע רק אם היישום יקבל את המוקד בעת הפעלתו. |
הארגומנט בשם windowstyle כולל את הערכים הבאים:
| קבוע | Value | תיאור |
|---|---|---|
| vbHide | 0 | החלון מוסתר והמוקד מועבר לחלון המוסתר. קבוע vbHide אינו ישים בפלטפורמות Macintosh. |
| vbNormalFocus | 1 | המוקד מוצג בחלון והוא משוחזר לגודלו ולמיקומו המקוריים. |
| vbMinimizedFocus | 2 | החלון מוצג כסמל עם מוקד. |
| vbMaximizedFocus | 3 | החלון מוגדל עם המיקוד. |
| vbNormalNoFocus | 4 | החלון משוחזר לגודלו ולמיקומו העדכניים ביותר. החלון הפעיל כעת נשאר פעיל. |
| vbMinimizedNoFocus | 6 | החלון מוצג כסמל. החלון הפעיל כעת נשאר פעיל. |
הערות
אם הפונקציה Shell מבצעת בהצלחה את הקובץ בעל השם, היא מחזירה את מזהה המשימה של התוכנית שהופעלה. מזהה הפעילות הוא מספר ייחודי המזהה את התוכנית הפועלת. אם לפונקציית המעטפת אין אפשרות להפעיל את התוכנית בעלת השם, תתרחש שגיאה.
ב- Macintosh, vbNormalFocus, vbMinimizedFocus ו- vbMaximizedFocus כולם מציבים את היישום בחזית; vbHide, vbNoFocus, vbMinimizeFocus ממקמים כולם את היישום ברקע.
הערה
כברירת מחדל, הפונקציה 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)