GBC 4.01
Customization
How customization works
Planning for the customization Getting the customization to the user
Set up your GBC build environment Create a customization project Rebuild the GBC
Create a runtime package Deploy on GAS Deploy on JGAS Change the version customization suffix
Manage themes
Add a theme part Add a theme Modify a theme Delete a theme
Replace an image
Change the favicon Change background image for empty tabbed container
Use theme variables
Display or hide the sidebar Customize the chromebar Change checkbox icons Display the Genero context menu Change relog prompt
Use style sheets
Center progress indicator icon Center file loading icon
Use widgets
Add header image Add header image using style class Add header text Add footer text Change file loading icon Redirect application end Extend the MainContainerWidget
Internationalize your app
Add localized text Configure right-to-left languages Customize translation text Default encoding
Migrating customizations
Customization

GBC customizations allow you to determine how the application displays at runtime.

IMPORTANT: Some interface changes can be made using Genero presentation styles. Where possible, it is recommended that you use these presentation styles instead of GBC customizations. For information about presentation styles, see the Genero Business Development Language User Guide.

Customizations are comprised of themes and theme parts, as described in How customization works.

NOTE: For information about how customizations and themes are selected at runtime, see Selecting customizations and themes.

Before you develop your customizations, you need to set up the working environment; see Set up your GBC build environment. You can then set up your customization project; see Create a customization project.

Use themes to change the look-and-feel of your application; see Manage themes.

You can customize your UI by a number of methods. From simplest to most complex:

  1. For a few specific needs, you can simply replace an existing file. For example, to update the favicon image, you overwrite the current gbc_logo.ico file. See Replace an image.
  2. You can update the UI by setting theme variables. For example, you can use theme variables to display or hide the sidebar. See Use theme variables.
  3. You may need to edit a style sheet. For example, you can edit a style sheet to display a loading icon in the center of the screen. See Use style sheets.
  4. You may need to edit a widget. For example, you edit a header widget to modify the application header. See Use widgets.

IMPORTANT: Use the simplest method possible. If you can complete the customization requirement by setting a theme variable or by editing a widget, then set the theme variable! Editing a widget should be a last resort.

After you have completed your customization, you must compile and deploy it; see Rebuild the GBC.

GBC applications can be translated and modified for international markets; see Internationalize your app.

For information about moving your customizations to a new version of GBC, see Migrating customizations.