Funkce Shell

Platí pro
Access pro Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Poznámka

Funkce, metoda, objekt nebo vlastnost popsané v tomto tématu jsou zakázány, pokud je služba Microsoft Jet Expression Service spuštěna v režimu izolovaného prostoru (sandbox), který znemožňuje vyhodnocení potenciálně nebezpečných výrazů. Další informace o režimu izolovaného prostoru vyhledáte zadáním dotazu "režim izolovaného prostoru" v nápovědě.

Spustí spustitelný program a v případě úspěchu vrátí hodnotu Variant (Double) představující ID úlohy programu, jinak vrátí nulu.

Syntaxe

Shell(název_cesty [, styl okna ] )

Syntaxe funkce Shell obsahuje tyto argumenty:

Argument Popis
název_cesty Povinný argument. Proměnná (String). Název programu, který se má spustit, a všechny požadované argumenty nebo přepínače příkazového řádku; Může obsahovat adresář nebo složku a jednotku. Na počítačích Macintosh můžete použít funkci MacID k určení podpisu aplikace místo jejího názvu. V následujícím příkladu se používá podpis aplikace Microsoft Word:Shell MacID("MSWD")
styl okna Nepovinný argument. Proměnná (Integer) odpovídající stylu okna, ve kterém se má program spustit. Pokud je windowstyle vynechán, program se spustí minimalizovaný s fokusem. Na Macintoshi (System 7.0 nebo novější) windowstyle určuje pouze to, zda aplikace získá fokus při svém spuštění.

    

Pojmenovaný argument windowstyle má tyto hodnoty:

Konstanta Hodnota Popis
vbHide 0 Okno je skryté a fokus se přenese do skrytého okna. Konstanta vbHide není použitelná na platformách Macintosh.
vbNormalFocus 1 Okno má fokus a obnoví se původní velikost a umístění.
vbMinimizedFocus 2 Okno se zobrazí jako ikona s fokusem.
vbMaximizedFocus 3 Okno se maximalizuje s fokusem.
vbNormalNoFocus 4 Okno se obnoví do své poslední velikosti a umístění. Aktuálně aktivní okno zůstane aktivní.
vbMinimizedNoFocus 6 Okno se zobrazí jako ikona. Aktuálně aktivní okno zůstane aktivní.

    

Poznámky

Pokud funkce prostředí pojmenovaný soubor úspěšně spustí, vrátí ID úlohy spuštěného programu. ID úlohy je jedinečné číslo, které identifikuje spuštěný program. Pokud funkce Shell nemůže pojmenovaný program spustit, dojde k chybě.

Na Macintoshi vbNormalFocus, vbMinimizedFocus a vbMaximizedFocus všechny umístí aplikaci do popředí; vbHide, vbNoFocus, vbMinimizeFocus všechny umístí aplikaci na pozadí.

Poznámka

Ve výchozím nastavení funkce Shell spouští jiné programy asynchronně. To znamená, že program spuštěný s prostředím Shell nemusí být dokončen před spuštěním příkazů, které následují za funkcí Shell .

Příklad

Poznámka

Následující příklady ukazují použití této funkce v modulu VBA (Visual Basic pro Applications). Pokud chcete další informace o práci s modulem VBA, vyberte Referenční informace pro vývojáře, které najdete v rozevíracím seznamu vedle položky Hledat a do vyhledávacího pole napište požadované pojmy.

Tento příklad používá funkci Shell ke spuštění aplikace určené uživatelem. Na počítačích MacIntosh je výchozí název jednotky "HD" a části názvu cesty jsou místo zpětných lomítek oddělené dvojtečkami. Podobně byste místo \Windows použili složky Macintosh.

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