Shell függvény

Hatókör
Microsoft 365-höz készült Access Access 2024 Access 2021 Access 2019 Access 2016

Megjegyzés

A témakörben ismertetett függvény, metódus, objektum vagy tulajdonság le van tiltva, ha a Microsoft Jet Expression Service védőfalas üzemmódban fut, mivel ez megakadályozza az esetleg nem biztonságos kifejezések kiszűrését. A védőfalas üzemmódról a súgóban a „védőfalas üzemmód” kifejezésre keresve talál további információt.

Egy végrehajtandó programot futtat, amely Variáns (Double) típusú értéket ad eredményül, amely sikeres futás esetén a program feladatazonosítója, különben nulla.

Szintaxis

Shell(pathname [, windowstyle ] )

A Shell függvény argumentumai a következők:

Argumentum Leírás:
elérési út Kötelező megadni. Variáns (Karakterlánc). A végrehajtandó program neve és a szükséges argumentumok vagy parancssori kapcsolók; könyvtárat vagy mappát és meghajtót tartalmazhat. Macintosh rendszeren az alkalmazás aláírását is megadhatja a név helyett a MacID függvénnyel. Az alábbi példa a Microsoft Word aláírását használja:Shell MacID("MSWD")
ablakstílus Nem kötelező. Variáns (Egész), amely megadja annak az ablaknak a stílusát, amelyben a programot futtatni szeretné. Ha nem adja meg az ablakstílust , a program a fókusz hatására kis méretűre lesz állítva. Macintosh rendszeren (System 7.0 vagy újabb) a windowstyle csak azt határozza meg, hogy az alkalmazás kapja-e a fókuszt futtatáskor.

    

A windowstyle nevű argumentum az alábbi értékeket tartalmazza:

Állandó Érték Leírás:
vbHide 0 Az ablak rejtett, és a rejtett ablak kapja a fókuszt. A vbHide állandó nem alkalmazható Macintosh platformokon.
vbNormalFocus 1 Az ablak fókuszban van, és az eredeti helyén és méretében fut.
vbMinimizedFocus 2 Az ablak fókuszban lévő ikonként jelenik meg.
vbMaximizedFocus 3 Az ablak teljes méretben, fókuszban jelenik meg.
vbNormalNoFocus 4 Az ablak a legutóbbi méretében és helyén fut. Az aktuálisan aktív ablak marad aktív.
vbMinimizedNoFocus 6 Az ablak ikonként jelenik meg. Az aktuálisan aktív ablak marad aktív.

    

Megjegyzések

Ha a Shell függvény sikeresen végrehajtja a megnevezett fájlt, az elindított program feladatazonosítóját adja eredményül. A feladatazonosító egy egyedi szám, amely azonosítja a futó programot. Ha a Shell függvény nem tudja elindítani a megnevezett programot, hiba történik.

Macintosh rendszeren a vbNormalFocus, a vbMinimizedFocus és a vbMaximizedFocus állandó az előtérbe; a vbHide, a vbNoFocus és a vbMinimizeFocus a háttérbe helyezi az alkalmazást.

Megjegyzés

A Shell függvény alapértelmezés szerint aszinkron módon futtatja a többi programot. Így előfordulhat, hogy a Shell függvénnyel elindított program még nem fejezi be a működését, amikor a Shell függvény utáni utasításokat végrehajtja a rendszer.

Példa

Megjegyzés

A következő példák egy Visual Basic for Applications (VBA) modulban mutatják be a függvény használatát. A VBA használatáról a Keresés elem mellett található legördülő listából a fejlesztői forrásokat választva, majd egy vagy több keresőszót megadva kaphat további tájékoztatást.

Ebben a példában a Shell függvénnyel egy felhasználó által megadott alkalmazást futtathat. Macintosh rendszerben az alapértelmezett meghajtónév a „HD”, és az elérési út részei között fordított perjelek helyett kettőspontok állnak. Ugyanígy a \Windows mappák helyett Macintosh mappák szerepelnek.

' 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)