ExternalApps Collection

The ExternalApps collection provides information about configured external applications.

Members Table

Members


Properties	Description
Count	The number of configured external applications.

Methods	Description
CloseStartedApplications	Terminates all configured external applications.
IsProcessRunning	Determines if a specified process is running.
Item	Returns one item of the collection.
Run	Runs an external application.
RunElevated	Runs an external application as administrator.
RunSync	Runs an external application and returns the exit code.

Remarks

Note that the path of a file using SiteKiosk objects must be allowed in the
SiteKiosk configuration (Security -> Access -> URL's With Script Permission)
if it is not a browser skin file.

Examples

<html>
<body>
<table border="0" bgcolor="#ebebeb" width="600" cellspacing="5"
cellpadding="5" style="font-family:verdana;font-size:8pt;"
align="center">
<tr><td bgcolor="f8f8f8">
The following example lists all external programs that have
been configured in the SiteKiosk Configuration. Click to
start them.
</td></tr>
<tr><td style="font-family:verdana;font-size:8pt;">
<pre>
<SCRIPT TYPE="text/javascript">
window.external.InitScriptInterface();
if (SiteKiosk.ExternalApps.Count)
{
   if (SiteKiosk.ExternalApps.Count == 1)
   document.writeln("1 program has been configured\n");
   else
   document.writeln(SiteKiosk.ExternalApps.Count +
   " programs have been configured\n");
   document.writeln("<input name='id_chkrunflag' " +
   "type='checkbox' checked>don't start running programs\n");
   for (var i = 1; i <= SiteKiosk.ExternalApps.Count; ++i)
   {
      if (i != 1) document.writeln("");
      if (SiteKiosk.ExternalApps.Item(i).DisplayText == "")
      eaappname = "No description available";
      else eaappname = SiteKiosk.ExternalApps.Item(i).DisplayText;
      document.write("<a href='javascript:earunapp(" + i +
      ")' style='text-decoration:none;'>" + eaappname + "</a>");
   }
}
else
{
   document.write("Status: No programs have been configured");
}
function earunapp(appnr)
{
   SiteKiosk.ExternalApps.Item(appnr).Run(id_chkrunflag.checked);
}
</SCRIPT>
</pre>
</td></tr>
</table>
</body>
</html>

Applies to

SiteKiosk v5.0 (and later versions).