Metodo IShellDispatch2.ShellExecute

Esegue un'operazione specificata in un file specificato.

Sintassi

iRetVal = IShellDispatch2.ShellExecute(
  sFile,
  [ vArguments ],
  [ vDirectory ],
  [ vOperation ],
  [ vShow ]
)

IShellDispatch2.ShellExecute( _
  ByVal sFile As BSTR, _
  [ ByVal vArguments As Variant ], _
  [ ByVal vDirectory As Variant ], _
  [ ByVal vOperation As Variant ], _
  [ ByVal vShow As Variant ] _
) As Integer

Parametri

sFile [in]

Tipo: BSTR

Stringa contenente il nome del file in cui ShellExecute eseguirà l'azione specificata da vOperation.

vArguments [in, facoltativo]

Tipo: Variant

Stringa che contiene i valori dei parametri per l'operazione.

vDirectory [in, facoltativo]

Tipo: Variant

Percorso completo della directory contenente il file specificato da sFile. Se questo parametro non è specificato, viene usata la directory di lavoro corrente.

vOperation [in, facoltativo]

Tipo: Variant

L'operazione da eseguire. Questo valore è impostato su una delle stringhe verbo supportate dal file. Per una discussione dei verbi, vedere la sezione Osservazioni. Se questo parametro non è specificato, viene eseguita l'operazione predefinita.

vShow [in, facoltativo]

Tipo: Variant

Raccomandazione su come visualizzare inizialmente la finestra dell'applicazione. L'applicazione può ignorare questa raccomandazione. Questo parametro può avere uno dei valori seguenti. Se questo parametro non è specificato, l'applicazione usa il valore predefinito.

Valore	Significato
0	Aprire l'applicazione con una finestra nascosta.
1	Aprire l'applicazione con una finestra normale. Se la finestra viene ridotta al minimo o ingrandita, il sistema lo ripristina nella dimensione e nella posizione originale.
2	Aprire l'applicazione con una finestra ridotta a icona.
3	Aprire l'applicazione con una finestra ingrandita.
4	Aprire l'applicazione con la relativa finestra con le dimensioni e la posizione più recenti. La finestra attiva rimane attiva.
5	Aprire l'applicazione con la relativa finestra in corrispondenza delle dimensioni correnti e della posizione.
7	Aprire l'applicazione con una finestra ridotta a icona. La finestra attiva rimane attiva.
10	Aprire l'applicazione con la relativa finestra nello stato predefinito specificato dall'applicazione.

 

Commenti

Questo metodo viene implementato e accessibile tramite il metodo Shell.ShellExecute .

Questo metodo equivale all'avvio di uno dei comandi associati al menu di scelta rapida di un file. Ogni comando è rappresentato da una stringa verbo. Il set di verbi supportati varia da file a file. Il verbo più comunemente supportato è "aperto", che è anche il verbo predefinito. Altri verbi possono essere supportati solo da determinati tipi di file. Per altre discussioni sui verbi di Shell, vedere Avvio di applicazioni o estensione dei menu di scelta rapida.

Questo metodo non è attualmente disponibile in Microsoft Visual Basic.

Esempio

Negli esempi seguenti viene illustrato l'uso di ShellExecute per aprire Il blocco note. L'utilizzo viene visualizzato per JScript e VBScript.

Jscript:

<script language="JScript">
    function fnShellExecuteJ()
    {
        var objShell = new ActiveXObject("shell.application");
        
        objShell.ShellExecute("notepad.exe", "", "", "open", 1);
    }
</script>

Vbscript:

<script language="VBScript">
    function fnShellExecuteVB()
        dim objShell

        set objShell = CreateObject("shell.application")

        objShell.ShellExecute "notepad.exe", "", "", "open", 1

        set objShell = nothing
    end function
</script>

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (versione 5.0 o successiva)