הערה: הפונקציה, פעולת השירות, האובייקט או המאפיין המתוארים בנושא זה אינם זמינים אם שירות הביטויים של Microsoft Jet פועל במצב ארגז חול (Sandbox) שמונע הערכה של ביטויים שעלולים להיות לא בטוחים. לקבלת מידע נוסף על מצב ארגז חול, חפש את "מצב ארגז חול" בעזרה.
הפעלת תוכנית הפעלה והחזרת משתנה (כפול) המייצג את מזהה המשימה של התוכנית אם היא הצליחה, אחרת היא מחזירה אפס.
תחביר
Shell( pathname [, windowstyle ] )
תחביר הפונקציה Shell מכיל את הארגומנטים הבאים:
|
ארגומנט |
תיאור |
|
שם נתיב |
נדרש. משתנה (מחרוזת). שם התוכנית לביצוע וכל הארגומנטים הנדרשים או בוררי שורת פקודה; עשוי לכלול ספריה או תיקיה וכונן. ב- Macintosh, באפשרותך להשתמש בפונקציה MacID כדי לציין חתימה של יישום במקום את שמה. הדוגמה הבאה משתמשת בחתימה עבור Microsoft Word: Shell MacID("MSWD") |
|
סגנון חלון |
אופציונלי. משתנה (מספר שלם) התואם לסגנון החלון שבו יש להפעיל את התוכנית. אם windowstyle מושמט, התוכנית מופעלת ממוזערת עם המוקד. ב- Macintosh (מערכת 7.0 ואילך), windowstyle קובע רק אם היישום מקבל את המוקד בעת הפעלתו. |
הארגומנט בעל השם 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)
