Simple Script Function

This is an example of a script function that displays the name of the largest file in the current folder, and gives you the option to select it.

To use this function you would:

• Create a new toolbar button or hotkey and edit it
• Click the Advanced button in the command editor to switch to the advanced command editor
• Set the Function drop-down to Script Function

@script jscript

// main script entry point. clickData is a ClickData object

function OnClick(clickData) {

    // initialise a variable to keep track of the largest file
    largestFile = null;

    // create an enumerator object that will let us easily enumerate the files in the current tab.

    // clickData.func is a Func object

    // func.sourcetab is a Tab object

    // sourcetab.files is a collection of Item objects

    enumFiles = new Enumerator(clickData.func.sourcetab.files);
    enumFiles.moveFirst();

    // enumerate the files in the tab
    while (enumFiles.atEnd() == false) {

        // if this is the largest file encountered so far, keep track of it

        // the file size is obtained from the Item object via its size property

        // we use the FileSize object's cy property as this makes it easier to compare

        // two sizes numerically
        if (largestFile == null || largestFile.size.cy < enumFiles.item().size.cy)
            largestFile = enumFiles.item();
        enumFiles.moveNext();
    }

    // create a Dialog object to display the results
    dlg = clickData.func.Dlg;
    if (largestFile == null) {

        // there were no files found, so show a warning message
        dlg.message = "There are no files in this folder!";
        dlg.buttons = "OK";
        dlg.icon = "warn";
    }
    else {

        // build the info message to report on the largest file
        // the dialog will have two buttons, giving the user the option to select the file
        dlg.message = "The largest file is '" + largestFile.name + "' - " + largestFile.size.fmt;
        dlg.buttons = "Select It|Cancel";
        dlg.icon = "info";
    }

    dlg.title = "Largest File Finder";

    // display the dialog. if the user clicks the "Select It" button it will return 1
    if (dlg.Show() == 1) {

        // initialise and run the Select command to select the largest file

        // this makes use of the Command object provided to the button via clickData.func
        clickData.func.command.ClearFiles();
        clickData.func.command.AddFile(largestFile);
        clickData.func.command.RunCommand("Select FROMSCRIPT DESELECTNOMATCH MAKEVISIBLE");
    }
    else {

        // not selecting a file, so make sure anything already selected is unaffected
        clickData.func.command.deselect = false;
    }
}