ExternalApps Collection



 
The ExternalApps collection provides information about configured external applications.


Members Table

    The following table lists the members provided by the ExternalApps collection.

    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
    This collection is available through the main object SiteKiosk. Use the ExternalApps collection to receive information about all applications configured in the SiteKiosk configuration.

    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
    The following example lists all configured external programs.

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

Back to top