Metodo Shell.ShellExecute

Esegue un'operazione specificata in un file specificato.

Sintassi

Jscript:

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

Vbscript:

iRetVal = Shell.ShellExecute( _
  sFile, _
  [ ByVal vArguments ], _
  [ ByVal vDirectory ], _
  [ ByVal vOperation ], _
  [ ByVal vShow ] _
)

VB:

Shell.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 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:

function ShellExecuteJS()
{
    var objShell = new ActiveXObject("Shell.Application");
    objShell.ShellExecute("notepad.exe", "", "", "open", 1);
}

Vbscript:

Function ShellExecuteVB()
    Dim objShell
    Set objShell = CreateObject("Shell.Application")
    Call objShell.ShellExecute("notepad.exe", "", "", "open", 1)
End Function

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)