Icon Modifying Project Options

The project options for a project include:
  • General application options (title, icon, whether to show load progress)

  • Auto-creation of forms and databases in visual applications

  • Compilation options (search paths, output paths, output compression)

  • External Files

  • Deployment options
Use the following steps to modify the project options for a project:
  • Click on the Project option in the main menu. The Project menu will open:

    Image


  • Click on the Options option in the Project menu to open the Project Options dialog.
Image

Application
For visual applications, the Application page provides options for specifying the title of the application, the icon to display in the browser window for the application, and whether or not to show load progress.

Image

OptionDescription
TitleThe application title is the descriptive name for the application and, in most modern browsers, will appear in the caption bar of the browser window.
IconThe application icon is a 16x16 or 32x32 Windows icon file that is displayed in the browser window next to the application title. This icon is commonly known as a "favicon" (short for "favorite icon") because the icon is also used to help identify the application in "favorites" or "bookmarks" in the browser.

You can type in the file name directly, or use the browse button (...) to select the icon file using a common Windows file dialog. After a valid file name has been specified or selected, a preview of the icon file will be shown in the Preview area.

Information You do not have to specify an icon for an application. It is completely optional.
Show load progressIf checked, this option will turn on the load progress dialog for the application. This dialog is shown while all forms marked as auto-create are being created. See the Forms section below for more information on determining which forms will be auto-created.

Forms and Databases
For visual applications, the Forms and Databases page allows you to specify which forms and databases in the project should be auto-created, and which forms and databases should not be auto-created. The first form in the list of auto-create forms and databases is automatically designated as the main form of the application, but you can select a different auto-create form as the main form using the combo box at the top of the page.

Image

All updates to the main form and/or the auto-create forms and databases list will be reflected in the project source file. The following shows the project source file that corresponds to the auto-create forms and databases list above:

Image

OptionDescription
Main FormThe main form is set to the first form that is designated as auto-create, or blank if no forms are designated as auto-create. You can select a different main form by using this combo box.
Auto-Create Forms and DatabasesThe IDE can be configured, via the Environment Options dialog, to automatically add any new forms and databases created or added to a project to this list. If you don't want a form or database to be automatically created, you can move the form or database to the available list box by dragging and dropping the desired form or database into the Available Forms list box. You can select multiple forms and databases to drag and drop by holding down the Ctrl key and selecting the forms and databases using the mouse.
Available Forms and DatabasesThis list box shows all forms and databases that are part of the project, but aren't marked as auto-create.

Warning If you try to show or hide a form that has not been created yet, and is not set as auto-create, you will get a run-time error in the web browser. Likewise, a similar run-time error will occur if you try to access any components on a form or database that haven't been created yet, such as trying to access a dataset in a database.

Compilation
The Compilation page allows you to configure the compilation options for both visual and non-visual projects.

Image

OptionDescription
Search PathsIn many cases you will not need to include any additional compilation search paths for a project. By default, the compiler will look in the project source folder and the component library search paths for any referenced units. Please see the Modifying Environment Options topic for more information on modifying the component library search paths. However, in certain cases you may want to include additional search paths for common library source units or custom control interfaces that are used between multiple projects, and this is where you would do so. When specifying more than one search path, be sure to separate multiple paths with a semicolon (;).
Output PathThis path specifies the output path where the application HTML (.html) loader file and application JavaScript (.js) source file will be emitted. This path is relative to the main project source folder. If you specify an absolute path here, the IDE will automatically convert it to a relative path when the Project Options dialog is closed by clicking on the OK button.
Output LoaderThis file name specifies the emitted output name of the application HTML (.html) loader file.
Output ScriptThis file name specifies the emitted output name of the application JavaScript (.js) file.
Show Hints/WarningsMake sure these check boxes are selected (default) in order to see all hints and warnings from the compiler about unused variables and other compilation conditions that you may need to know about.
Compressed OutputWhen this check box is selected, the compiler will emit the HTML and JavaScript for the application in a highly-compressed and obfuscated form. This normally can reduce the size of the resulting HTML and JavaScript files by 50% or more.
Icon FontThis file name specifies the icon font file to use for the embedded icons used with Elevate Web Builder. The icon font file name can use absolute or relative paths, but it is recommended that you use an absolute path in the file name so that there isn't any issue with the compiler finding the icon font file. By default, the icon font file is set to the default icon font file EWBIcons located in the \fonts subdirectory under the main installation directory. Please see the Icon Library topic for more information on using icon fonts with Elevate Web Builder.
Embed in loaderThis check box controls whether the specified icon font file name is embedded directly in the HTML loader file created when compiling an application, or whether a link to the icon font file name is used instead. By default, the icon font file will be embedded in the HTML loader file. Please see the Compiling Applications topic for more information on compiling projects with Elevate Web Builder.

External Files
The External Files page allows you to configure which external files (external Javascript, images, etc.) you want to include with your project.

Image

When you include an external file with your project, the compiler will copy the source file to the output path for the project and, if necessary, emit a reference to this source file in the HTML loader file that is also emitted into the output path during compilation. Some external files such as external Javascript source code require a link to the file in the emitted HTML loader file. Please see the External Interfaces topic for more information on interfacing external JavaScript source code in your application source code.

Deployment
The Deployment page allows you to configure how your project should be deployed when the Deploy option is selected from the main menu or main toolbar. There are two deployment methods currently available for a project:

MethodDescription
CopyThis is the default method and only requires a destination path name to use for the destination of the copy operation.
FTPThis deployment method will use the File Transfer Protocol (FTP) to copy all output files for the application to the specified destination path on the specified FTP server.

Warning During deployment, the IDE will try to create any output directories that are required, so you should make sure that you have the proper user privileges for the destination path for either deployment method.

Deploying When an Application is Run

Use the Deploy On Run check box to select whether the application should automatically deployed before it is run in the IDE. This is useful for applications that are being run from an external web server and need to be deployed to the external web server prior to being run. This option is ignored when an application is run from the internal web server that is embedded in the IDE.

Copy

Image

OptionDescription
Destination PathThis is the path where all application output files will be copied. The default value is blank (""), and you must specify a path or the deployment will fail with an error.

FTP

Image

OptionDescription
FTP Server Host Name or IP AddressThis option specifies the host name (domain name) or IP address (XXX.XXX.XXX) of the FTP server where the application output files should be deployed.
PortThis is the port number on which the FTP server is listening. The default port for FTP servers is port 21.
User NameThis is the user name to use when logging in to the FTP server. If the FTP server does not require a user name and password, then leave this option blank (the default).
PasswordThis is the password to use when logging in to the FTP server. If the FTP server does not require a user name and password, then leave this option blank (the default).
Destination PathThis is the path where all application output files will be copied. The default value is blank (""), and this indicates to copy all application output files to the root directory of the FTP server.

The Test Connection button can be used to verify that you configured the FTP server and login options correctly. If you have done so properly, then you will see a message dialog affirming the fact that the IDE was able to successfully connect and login to the specified FTP server. If there is an error making the connection or logging in with the specified user name and password, then you will see a message dialog with the appropriate error message that indicates the problem.
Image