Site Tools


New release available: 2020-07-29 "Hogfather". upgrade now! [51.3] (what's this?)
New release candidate 3 available: 2020-06-09 "Hogfather". upgrade now! [51.2] (what's this?)
New release candidate 2 available: 2020-06-01 "Hogfather". upgrade now! [51.1] (what's this?)
New release candidate available: 2020-06-01 "Hogfather". upgrade now! [51] (what's this?)
Hotfix release available: 2018-04-22c "Greebo". upgrade now! [50.3] (what's this?)


Function that shows the user a dialog to choose a project to open. The user must select an XPJ file to open the project. The difference between this function and the function openproject() is that this function will prompt the user for a project.

Note: Always use this function or the function openproject() to open a project. This ensures that the global variable currentProject is set. If this variable is not set, several functions in the library may not work as expected.


To open a project and check that the user didn't cancel in the dialog:

if(openprojectdialog()) {
  //Do something for the project.
} else {
  alert('You must open a project to run this script");


Parameter Data type Required Description
updateifrequired boolean If set to true the project will be updated if the project is from a previous version. Default is false

Return Values

Value Meaning
true The project was opened
false The project could not be opened
project/openprojectdialog.txt · Last modified: 2020/02/26 17:10 (external edit)