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:
// Set the script type to JScript to use this script
// 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;
}
}