top trim

Mehr über Scripting

Wenn eine Boxely Anwendung ausgeführt wird, sind mehrere Singleton Objekte verfügbar: shell, scene, und appUtils. Diese Objekte, und einige ihrer Methoden, werden in diesem Teil beschrieben.

Shell Class

Eine shell ist ein Singleton und ist, essentiellerweise, vorherrschend in allen Szenen. Sie analysiert, erstellt, und zerstört Szenen. Die shell enthält auch alles andere, das auf dem globalen (über allen Szenen) Level ist.

Einige Methoden, die für diese Klasse definiert sind folgen.

  • getCurrentEvent - Diese Methode gibt den aktuellen Event zurück.

  • getSceneAt -- Diese Methode gibt das Szenenobjekt mit dem festgelegten Namen zurück.

  • openScene - Diese Methode erstellt und öffnet ein neues Szenenobjekt von einer festgelegten URL (die auf eine .box Datei verweist) die von einem Parameter an die Methode übergeben wird.

  • closeScene - Diese Methode schließt und entfernt die festgelegte Szene.

Scene Class

Eine Szene ist eine Einheit, die einen Baum an Gadgets oder Komponenten (das DOM) und andere unterstützende Ressourcen wie Verhaltensweisen und themes enthält. Die Szene ist das, was eine einzelne sichtbare Region ausmacht.

Eine Liste mit einigen Methoden, die für diese Klasse definiert sind folgt.

  • alert - Diese Methode blendet ein Meldungsfenster mit gegebener Nachricht ("message") und Titel ("title") ein.

  • confirm - Diese Methode blendet ein Bestätigungsfenster mit gegebener Nachricht ("message") und Titel ("title") ein.

  • createBox - Diese Methode erstellt eine Box eines bestimmten Typs (wie vbox, hbox, oder eines eigenen Gadgets). Sobald sie erstellt ist kann sie in die Szene eingefügt werden, durch Verwendung von addChild oder insertChildAt Methoden.

  • getBoxById - Diese Methode gibt das "Box" Objekt, das mit gegebener ID verbunden ist, zurück.

appUtils Class

Die AppUtils Klasse stellt einige Mechanismen zur Verfügung um mit anderen Boxely Objekten zu interagieren.

Eine Liste mit einigen Methoden, die für diese Klasse definiert sind folgt.

  • boxURLToPath - Diese Methode gibt den absoluten Pfad des "boxURL" Parameters zurück.

  • browseFolderDialog - Präsentiert eine Systemdialogauswahl. Gibt die aktuelle Auswahl als String zurück. Wenn der Dialog abgebrochen wird, ist der String Null.

  • playSound - Diese Funktion spielt eine Sounddatei ab, die mit Pfad und Dateiname festgelegt ist, und als Parameter an die Funktion übergeben werden.

  • saveFileDialog - Präsentiert einen System Datei speichern Dialog. Gibt die aktuelle Auswahl als String zurück.

bottom trim