Icon Modifying Environment Options

The Environment Options dialog allows you to configure the following aspects of the Elevate Web Builder IDE:
  • The project options settings

  • The code editor settings

  • The code editor display settings

  • The designer settings

  • The component library settings

  • The internal web server settings

  • The web server modules added to the internal web server

  • The external web servers added to the IDE

  • The help files added to the IDE
Use the following steps to modify the environment options for the IDE:
  • Click on the Environment option in the main menu. The Environment menu will open:

    Image


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

Project Options
The Project Options page provides options for modifying the project options settings.

Image

OptionDescription
Automatically save before project compilationSelect this check box to make sure that the IDE automatically saves all modified units and project files before compiling the currently-loaded project. This option is selected, by default.
Save/restore non-project files with projectSelect this check box to have the IDE automatically save and restore any units that are open in the IDE, but are not actually part of the currently-loaded project. This option also applies to control interfaces that are open in the IDE and is selected, by default.
Automatically load custom control interfaces in project search pathsSelect this check box to have the IDE automatically load any custom control interface files located in the project's compiler search paths whenever a project is opened in the IDE. When checking to see if a control interface has been customized, the IDE compares the path of the default control interface file used with the component library (based upon the Library Search Paths setting on the Component Library page) with the path of any control interfaces with the same file name present in the project's compiler search paths. If a match is found, then the control interface file found in the project's compiler search paths is loaded into the IDE and used with the project's form designers. After the project is closed, the default control interfaces are reloaded. This check box is selected, by default.
Default ancestor form class for new form instancesSpecifies the default ancestor form class for the new form class selection dialog that is displayed when creating a new form in the IDE. The default ancestor form class is the TForm class.
Default ancestor database class for new database instancesSpecifies the default ancestor database class for the new database class selection dialog that is displayed when creating a new database in the IDE. The default ancestor database class is the TDatabase class.
Automatically add new forms and databases to auto-created forms and databasesSelect this check box to make sure that any newly-create forms and databases are automatically added to the list of auto-created forms and databases for the application. This option is selected, by default.

Editor
The Editor page provides options for modifying the code editor settings.

Image

OptionDescription
Tab SizeThe number of spaces between each tab position. The default is 3 spaces.
Allow the cursor in white spaceSelect this check box in order to allow the cursor to be positioned in white space areas in the code editor. By default, if you move to an area of the code editor that is white space, the cursor will be moved to the next closest source code to the white space. The definition of "white space" in this context is the area of the code editor where there is no source code present.
Find text at cursorSelect this check box to have the code editor populate the Find or Replace search text box with the current word under the cursor when searching or replacing text in the code editor. By default, the last searched text will appear in the Find or Replace search text box.
Find wrap aroundSelect this check box to have the code editor wrap around to the start/end of the source when searching or replacing text in the code editor. The direction in which the searching or replacing wraps is determined by the direction of the search or replace operation. By default, the code editor will stop when reaching the start/end of the source during a search or replace operation.
Prompt to reload external modificationsSelect this check box to have the code editor prompt the user when any source loaded in the code editor is modified by an external application. The prompt will ask the user to confirm whether they wish to load the modified source into the code editor. By default, the code editor will prompt the user when any source is changed by an external application.

Editor Display
The Editor Display page provides options for modifying the code editor settings.

Image

OptionDescription
FontUse this combo box to select the fixed-width font to use for all text in the code editor. The default code editor font is the "Courier New" font.
SizeThe size of the fixed-width font, in points. The default size is 10 points.
ElementUse this list box to select the various text elements present in the code editor and modify their visual properties such as their foreground and background colors and the style of the text.

Designer
The Designer page provides options for modifying the designer settings.

Image

OptionDescription
Display grid on designer surfaceSelect this check box to enable the display of an alignment grid on the designer surface. The default state is checked.
Snap controls to gridSelect this check box to cause the designer to automatically align any controls/elements to the grid when they are inserted, resized, or moved. The default state is checked.
Grid ColorSelect the color of the alignment grid. The default is clDodgerBlue.
Grid SizeThe number of pixels between each grid point in the alignment grid, both on the horizontal (X) and vertical (Y) axes. The default grid size is 8 pixels by 8 pixels.
Selection Point Active ColorSelect the color of selection points when the designer is active. The default is clDodgerBlue.
Selection Point Inactive ColorSelect the color of selection points when the designer is not active. The default is clGray.
Selection Point Visible SizeUse this edit to specify the visible size of selection points. The default size is 6 pixels (square).
Selection Point Mouse SizeUse this edit to specify the size of the area in which the mouse can operate on the selection points. If you are visually-impaired, then you may want to increase these values to make working with the selection points easier. The default is 10 pixels (square).

Component Library
The Component Library page provides options for modifying the component library settings.

Image

OptionDescription
Search PathsThe component library search paths are used to specify where the component library source unit files are located. These search paths ensure that the compiler can always find the component units, and any referenced control interfaces, installed into the component library, as well as any core units that are necessary for all Elevate Web Builder applications. The component library search paths are initially configured during installation. If you wish to add additional paths to the component library search paths, then this is where you would do so. When specifying more than one search path, be sure to separate multiple paths with a semicolon (;).

Information These search paths are global to both applications and the component library, but the project's search paths always take precedence over these search paths.
Validate standard components at startupSelect this check box to have the IDE check for the existence of the standard Elevate Web Builder components during startup. If any of the standard components are missing, or not found in their default location, then the user will be asked to confirm adding the missing standard components. By default, the IDE will always validate the standard components during startup.

Internal Web Server
The Internal Web Server page provides options for modifying the internal web server settings.

Image

OptionDescription
Auto-StartSelect this check box to specify that the internal web server should be automatically started when the IDE is started. The default is checked.
Listen on PortUse this edit to specify the port number that the internal web server should listen on. The default is port 80.
Databases Resource NameSpecifies the resource name to use for the automatic database handling built into the internal web server. The default value is 'databases'. Please see the Creating and Loading DataSets topic for more information on how this resource name is used in database requests.
Database Modules Resource NameSpecifies the resource name to use for any database modulesadded to the internal web server (see next). The default value is 'databasemodules'. Please see the Creating and Loading DataSets topic for more information on how this resource name is used in database requests.
Modules Resource NameSpecifies the resource name to use for the modules added to the internal web server. The default value is 'modules'. Please see the Creating Web Server Modules topic for more information on how this resource name is used in module requests.

Internal Web Server Modules
The Internal Web Server Modules page provides options for adding and removing modules (*.dll) that were created using Embarcadero RAD Studio and Delphi and an Elevate Web Builder Module template project from the repository in the RAD Studio IDE. Adding modules to the internal web server allows the modules to be used to respond to requests and provide content to the Elevate Web Builder application running in the IDE.

Image

Adding a Module

In order to add a module, complete the following steps:
  • Click on the Add button


  • The Add Module dialog will appear.

    Image

    In the dialog, specify the file name of the module (.dll) that you wish to add to the internal web server. You can type in the file name directly, or use the browse button (...) to select the module using a common Windows file dialog. If you use the browse button, the module description and version will be populated from the module after the file is selected. The description and version are read directly from the .dll's version information.


  • Click on the OK button. If the specified file is a valid Elevate Web Builder module, then the module will be added to the internal web server. If the specified file is not a valid module file, then an error message will be displayed indicating any issues with the module file.
Removing a Module

In order to remove a module, complete the following steps:
  • Select an existing module from the list of modules.


  • Click on the Remove button.
Information If you remove a module that is used by Elevate Web Builder applications, then you will experience errors in these applications when they try to execute requests that reference these modules in the URL for the request.

Please see the Creating Web Server Modules topic for more information how the modules work.

External Web Servers
The External Web Servers page provides options for adding external web servers for use in the IDE. Once an external web server is added, it can be selected as the target web server when running applications. Please see the Running a Project topic for more information on running applications.

Image

Adding an External Web Server

In order to add an external web server, complete the following steps:
  • Click on the Add button.


  • The Add External Web Server dialog will appear.

    Image


  • In this dialog, specify the name of the external web server that you wish to add to the IDE. This will be used to uniquely identify the external web server.

    Next, specify the short description of the external web server. This will be used in the web server selection combo box in the IDE.

    Next, specify the URL of the external web server. This will be used by the web browser in the IDE to load an application from the external web server when is it is the currently-selected web server.

    Finally, specify the port on which the external web server will listen for requests from the web browser in the IDE. The default port is 80, which is the standard web server port (HTTP protocol).


  • Click on the OK button. If all information for the external web server is specified correctly, then the external web server will be added to the IDE for use with your projects. If the specified external web server information is missing or invalid, then an error message will be displayed indicating any issues with the information.
Editing an External Web Server

In order to edit an external web server that is already added, complete the following steps:
  • Select an existing external web server from the list of web servers.


  • Click on the Edit button.


  • The Edit External Web Server dialog will appear.

    Image


  • Modify the external web server information as required.


  • Click on the OK button. If all information for the external web server is specified correctly, then the external web server will be added to the IDE for use with your projects. If the specified external web server information is missing or invalid, then an error message will be displayed indicating any issues with the information.
Removing an External Web Server

In order to remove an external web server, complete the following steps:
  • Select an existing external web server from the list of web servers.


  • Click on the Remove button.
Help
The Help page provides options for adding and removing help files (*.wbh). By default, the help for Elevate Web Builder is added automatically during the IDE startup process, so normally you will not need to add any additional help files. However, if you install any 3rd party components into the IDE, they may come with online help to use with the components, and that help can be added here.

Information The default Elevate Web Builder help file is always shown in the list of added help files, but it cannot be removed.

Image

Adding Help

In order to add a help, complete the following steps:
  • Click on the Add button.


  • The Add Help dialog will appear.

    Image


  • In this dialog, specify the file name of the help file (.wbh) that you wish to add to the IDE in the edit control. You can type in the file name directly, or use the browse button (...) to select the help file using a common Windows file dialog. If you use the browse button, the help file name and title will be populated from the help file after the file is selected.


  • Click on the OK button. If the specified file is a valid Elevate Web Builder help file, then the help file will be added to the IDE for use from the Help menu. If the specified file is not a valid help file, then an error message will be displayed indicating any issues with the help file.
Removing Help

In order to remove a help file, complete the following steps:
  • Select an existing help file from the list of help files.


  • Click on the Remove button.
Please see the Accessing Help topic for more information on accessing the help in the IDE.
Image