| sOperation | (String) Typ operacji z plikiem. Jeżeli parametr jest pusty łańcuch, wtedy parametrem domyślnym jest wartość "open".
"print" - Plik ma zostać wydrukowany
|
|---|---|
| sFile | (String) Nazwa pliku ze ścieżką.
Jeżeli nie jest wprowadzona pełna ścieżka, wtedy zostanie uzupełniona względem do foldera aplikacji. Jest zalecane stosowanie ścieżki w składni PROMOTIC - patrz PROMOTIC ścieżka do plików lub folderów. |
| sParameters | (String) Parametry, których przekazanie aplikacji skojarzonej z uruchamianym plikiem jest konieczne |
| sFolder | (String) Ścieżka do foldera roboczego aplikacji.
Jest zalecane stosowanie ścieżki w składni PROMOTIC - patrz PROMOTIC ścieżka do plików lub folderów. |
| vOptions | (Variant) Dodatkowe parametry
KeyVal - Dodatkowe parametry określone w postaci łańcucha. Dane są tutaj w formacie KeyVal, na przykład "state:hidden;timeout:10;"
state - Określa tryb wyświetlani aplikacji.
normal (domyślnie) - zwykła aktywna
max - zmaksymalizowana aktywna
min - zminimalizowana aktywna
hidden - ukryta
normal_na - zwykła nie aktywna
min_na - zminimalizowana nie aktywna timeout - Określa maksymalny czas operacji w sekundach. Domyślnie jest -1, oznaczające nieskończony timeout.
Jeżeli operacja nie zostanie zakończona w określonym czasie, wtedy wywoływana jest funkcja onComplete(ev), gdzie wartość zwrotna (parametr ev.Value) będzie undefined (nieprawidłowa). Number - Stary sposób określenia trybu wyświetlenia aplikacji przy pomocy liczby:
0 - ukryta
1 - zwykła aktywna
2 - zminimalizowana aktywna
3 - zmaksymalizowana aktywna
4 - zwykła nie aktywna
6 - zminimalizowana nie aktywna |
| sRequestId | [opcjonalne] (String) Identyfikator zarejestrowanej funkcji zdarzenia.
- Uniemożliwia ponowne zarejestrowanie tej samej funkcji.
- Może zawierać dowolne znaki (nie jest to nazwa systemowa).
- Nie może być pusty łańcuch. |
| onComplete | [opcjonalne] (Function) Parametr onComplete zawiera funkcję, która zostanie wywołana do asynchronicznego przekazania wyniku. Funkcja musi posiadać następujcą składnię: function onComplete(ev) {};
gdzie parametr ev.Value zawiera wartość zwrotną (wynik) asynchronicznego wołania. Wynikiem jest wartość zwracana przez uruchomioną aplikację po jej zakończeniu. Jeżeli nie wystąpił żaden błąd, wtedy wartość ta wynosi zazwyczaj 0. Jeżeli aplikacja nie została zakończona w czasie określonym przez parametr timeout, wtedy wartość zwrotna jest undefined. |
Pm.ShellExecute("print", "#app:experiment.htm", "", "#app:", 0);
Pm.ShellExecute("", "\\\\SERVER\\PRINTER1", "", "", 0);
Pm.ShellExecute("open", "C:\\PowerPoint\\presentation.pps", "", "C:\\PowerPoint\\", 1);
var sPathBrowser = "c:/Program Files (x86)/Microsoft/Edge/Application/";
Pm.ShellExecute("open", sPathBrowser + "msedge.exe", "c:/download/filename.pdf", sPathBrowser, 3);
var sUser = "ftpname:ftppassword";
var sFtpFile = "ftp://ftpservername.com/dir/filename.pdf";
var sLocalFile = "c:/Test/filename.pdf";
var sSend = ' -T "' + sLocalFile + '" -u "' + sUser + '" --url "' + sFtpFile + '"';
Pm.ShellExecute("open", "c:/Windows/System32/curl.exe", sSend, "", "state:hidden;", pMe.GetPathName(), onComplete);
function onComplete(ev)
{
if (!ev.Value)
{
Pm.Debug("FTP transfer is OK");
}
}