Advanced configuration options

Use the Advanced tab to configure the caches, the stored settings, dictionary lists, and buttons style.

Figure: Genero Desktop Client Options; Advanced Tab


This figure is a screen shot of the Genero Desktop Client in Administrative Mode, showing options in the Advanced Tab.
The following options can be configured in the Advanced panel:

Image Cache

The Genero Desktop Client stores images that have been retrieved remotely, such as when the images are retrieved using http (either because the url specifies http, or a PICTURE alias is used with Genero Application Server), or from the runtime system side (using FGLIMAGEPATH).

The size of the image cache can be configured. Images are stored in the AppCacheDir directory (see GDC configuration file directories). When the cache is full, those images which have not been recently used are removed from the cache.

A memory cache is used by GDC. Images that are frequently used are cached to be loaded as fast as possible.

The imageCache style has been introduced to manage the cache; the disk cache and memory cache. It can be applied to any item using images and defines whether GDC must cache the image (based on the url).

Values can be yes (cache is used) or no (cache is not used). The default behavior depends (as in previous versions) on the item type:

  • IMAGE fields are not cached.
  • All other items (button, toolbar items) are cached.
Note: When configuration settings for the image cache in GDC are modified in one monitor, the settings are applied to all monitors for a user. For example, if you delete the image cache in one monitor, it is also deleted in all other monitors.
Note that the image cache is common to all applications for a user. This can result in an error if the cache is enabled and there are image files with the same file name. Take the following example of an error that occurs when two applications try to display two different images with the same file name:
  1. The first application will write the first image to the cache.
  2. The second application, while trying to load the second image with the same name, will search the cache by file name and load the first image.
  3. The second application incorrectly displays the first image.

Proxy Cache

The Clear button will clear the cache.

Web cache

Web component widgets use webviews. Webviews created by the GDC share a common disk cache, known here as the Web cache.

When developing applications, the Web cache can prevent the developer from seeing changes in the Web component, as old versions of the files saved in the cache may be used instead of downloading the latest versions from the server. To force the webview to download the latest versions, users need to clear the cache.

The Clear button clears the cache.
Tip: It is recommended to close any applications displaying a webview prior to clearing the cache, as it will wipe all cache entries from the disk.

Stored settings

Stored settings refer to the storage of window and widget properties such as size, table layout (column order, width, sorting, and so on) on the platform where the GDC sits. These settings are stored for each program executed, and the settings are used when the program relaunches, so that the end user sees the same display when the application starts as they had when the application last terminated.

Settings are stored in the system registry on Windows®, in property list files on macOS™ and iOS, and in ini text files in Linux® systems. It is not recommended to modify those files or registry entries.

Select Disable to temporarily disable stored settings. When disabled, all widgets and windows use their defaults for size and display. The stored settings are not cleared (they remain on disk), but they are not used, nor are they updated on application end.

Select Read only to read the stored settings when forms are loaded, but not update the stored settings when the forms are closed. For example, assume the window of an application has been saved in maximized state. With the Read only option activated, you can resize the window or do whatever you want with the application; yet when you exit and restart the application it will be returned to its maximized state.

The Clear button clears all stored settings. This button is disabled if there are no stored settings to clear.

Attention: It is strongly recommend that you clear stored settings when migrating to a new major release of GDC. You might otherwise encounter some side effects due to corrections or new functionality.

Dictionary list

The dictionary list relates to the spellchecking feature for Web components.

Spellchecking of Web components is based on dictionaries stored in:
  • GDCDIR/bin/qtwebengine_dictionaries on Windows and Linux systems.
  • GDCDIR/Contents/Resources/qtwebengine_dictionaries on macOS systems.
The dictionaries are .bdic files. GDC populates the Select Language context menu for spellchecking of Web components based on the list of .bdic files found in this directory. GDC creates this list on startup; click Refresh to update the list based on the latest contents of the directory.

For the .bdic files packaged with GDC, a transposition of the file name is made to display the name of the language. For example, instead of "it_IT" you will see "Italian". For all added .bdic files, the name of the file is used in the context menu.

Buttons style

The look of the monitor and dialogs (shortcuts wizard, login, about box, debug console) buttons can be customized to match the look-and-feel of a regular Genero application.

Figure: Raised buttons with icons


Screen shot of Genero Desktop Client with raised buttons with icons

Figure: Raised buttons without icons


This figure is a screen shot of the Genero Desktop Client with raised buttons and no icons.