Lightning Launcher

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Create full blown settings screen =====

**Available at V14b3+.**

Although the feature is not part of the official script API, Lightning offers a set of public java classes for creating settings screens. It consists in ready to use controls to select a color, a number, a text, a value in a list or a boolean value. These controls are the one used by the app in its own settings screen.

These classes consist in 
  * a set of LLPreference* to manage color, number, text and other settings
  * a LLPreferenceListView class, used to display the LLPreference* instances


The api doc can be found at [[http://www.lightninglauncher.com/scripting/reference/api-beta/reference/net/pierrox/lightning_launcher/prefs/package-summary.html|http://www.lightninglauncher.com/scripting/reference/api-alpha/reference/net/pierrox/lightning_launcher/prefs/package-summary.html]]

The following script, extracted from the [[http://www.lightninglauncher.com/scripting/samples/Clock-2.1.tar.gz|Clock-2.1.tar.gz]] sample, construct a settings dialog box using the preferences classes.

<sxh javascript>
bindClass("android.app.AlertDialog");
bindClass("net.pierrox.lightning_launcher.prefs.LLPreferenceListView");
bindClass("net.pierrox.lightning_launcher.prefs.LLPreferenceColor");
bindClass("net.pierrox.lightning_launcher.prefs.LLPreferenceCheckBox");

// build and show a dialog with clock preferences
function showSettings() {
    var screen = getActiveScreen();
    var context = screen.getContext();

    // extract settings stored in the item tag
    var settings = JSON.parse(item.getTag("settings"));

    // description of our preferences
    var prefColor = new LLPreferenceColor(0, "Color", null, settings.color, null, true);
    var prefShowSeconds = new LLPreferenceCheckBox(0, "Show seconds", null, settings.showSeconds, null);

    // create a list view to display our preferences
    var listView = new LLPreferenceListView(context, null);
    listView.setPreferences([ prefColor, prefShowSeconds ]);

    // setup the dialog and assign its content view with the preference list view
    var builder=new AlertDialog.Builder(context);
    builder.setView(listView);
    builder.setTitle("Clock settings");
    builder.setPositiveButton("Save",{onClick:function(dialog,id){
        // update the settings and save them back in the item's tag
        settings.color = prefColor.getColor();
        settings.showSeconds = prefShowSeconds.isChecked();
        item.setTag("settings", JSON.stringify(settings));
        dialog.dismiss();
    }});
    builder.setNegativeButton("Cancel", null);
    builder.show();
}
</sxh>
Lightning Launcher

User Tools

Site Tools

Page Tools
