Funcția Shell

Se aplică la
Access pentru Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Notă

Funcția, metoda, obiectul sau proprietatea descrisă în acest subiect este dezactivată dacă Microsoft Jet Expression Service rulează în modul sandbox, ceea ce împiedică evaluarea expresiilor potențial nesigure. Pentru mai multe informații despre modul sandbox, căutați "modul sandbox" în Ajutor.

Rulează un program executabil și returnează o variantă (Double) reprezentând ID-ul activității programului dacă reușește, altfel returnează zero.

Sintaxă

Shell(numecale [, stilfereastră ] )

Sintaxa funcției Shell are următoarele argumente:

Argument Descriere
nume cale Obligatoriu. Variant (șir). Numele programului de executat și orice argumente sau comutatoare de linie de comandă necesare; Poate include director sau folder și unitate. Pe Macintosh, puteți utiliza funcția MacID pentru a specifica semnătura unei aplicații în locul numelui său. Următorul exemplu utilizează semnătura pentru Microsoft Word:Shell MacID("MSWD")
stil de fereastră Opțional. Variant (număr întreg) corespunzător stilului ferestrei în care trebuie să fie rulat programul. Dacă windowstyle este omis, programul este pornit minimizat cu focalizare. Pe Macintosh (System 7.0 sau o versiune mai recentă), windowstyle determină doar dacă aplicația primește sau nu focalizarea atunci când este rulată.

    

Argumentul denumit windowstyle are aceste valori:

Constantă Valoare Descriere
vbHide 0 Fereastra este ascunsă, iar focalizarea este transmisă la fereastra ascunsă. Constanta vbHide nu se aplică pe platforme Macintosh.
vbNormalFocus 1 Fereastra este focalizată și este restaurată la dimensiunea și poziția sa inițială.
vbMinimizedFocus 2 Fereastra este afișată ca pictogramă cu focalizare.
vbMaximizedFocus 3 Fereastra este maximizată cu focalizare.
vbNormalNoFocus 4 Fereastra este restaurată la dimensiunea și poziția sa cea mai recentă. Fereastra activă în prezent rămâne activă.
vbMinimizedNoFocus 6 Fereastra este afișată ca pictogramă. Fereastra activă în prezent rămâne activă.

    

Observații

Dacă funcția Shell execută cu succes fișierul denumit, aceasta întoarce ID-ul de activitate al programului pornit. ID-ul de activitate este un număr unic care identifică programul care rulează. Dacă funcția Shell nu poate porni programul denumit, se produce o eroare.

Pe Macintosh, vbNormalFocus, vbMinimizedFocus și vbMaximizedFocus plasează aplicația în prim-plan; vbHide, vbNoFocus, vbMinimizeFocus plasează aplicația în fundal.

Notă

În mod implicit, funcția Shell rulează alte programe asincron. Aceasta înseamnă că este posibil ca un program pornit cu Shell să nu se termine de executat înainte de a se executa instrucțiunile care urmează funcției Shell .

Exemplu

Notă

Exemplele care urmează demonstrează utilizarea acestei funcții într-un modul Visual Basic for Applications (VBA). Pentru mai multe informații despre lucrul cu VBA, selectați Referințe pentru dezvoltatori în lista verticală de lângă Căutare și introduceți unul sau mai mulți termeni în caseta de căutare.

Acest exemplu utilizează funcția Shell pentru a rula o aplicație specificată de utilizator. Pe MacIntosh, numele implicit al unității este "HD" și porțiuni din numele căii sunt separate prin două puncte în loc de bare oblice inverse. În mod similar, specificați folderele Macintosh în loc de \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)