System Registry Keys for IDE Visual Settings

From RAD Studio
Jump to: navigation, search

Go Up to IDE Reference and Utilities


You can customize some of the visual settings of the IDE by adding or modifying system registry keys.

Note: Changes made to the Windows registry happen immediately, and no backup is automatically made. Do not edit the Windows registry unless you are confident about doing so.

Customizing the IDE Appearance

There are two ways to modify the system registry:

  1. Create a registry script file and execute it.
  2. Manually modify the system registry using regedit.

Creating a Registry Script File

  1. Create a new text document (you can use any text editor) and copy the following text into it:
  2. Windows Registry Editor Version 5.00
    
    [HKEY_CURRENT_USER\Software\Embarcadero\BDS\20.0\Theme]
    "FontName"="Segoe UI"
    "FontSize"=dword:0000000a
    "MainToolBarColor"="clGradientActiveCaption"
    
    Note: See the table of customizable values for details about the specified values.
  3. Save the document with the .reg extension.
  4. Execute the registry script file that you created. A warning about changing the registry may appear. You must accept it in order to apply the changes.
  5. Note: You may need Administrator permissions to be able to execute registry script files. If the IDE is open when you set or change registry values, you must restart the IDE for the values to take effect.

Manually Modifying Registry Keys

  1. Open system registry (type regedit into the searchbar on the Windows Start menu)
  2. Create a new registry key Theme in HKEY_CURRENT_USER\Software\Embarcadero\BDS\20.0\ (the complete path of the new key is: HKEY_CURRENT_USER\Software\Embarcadero\BDS\20.0\Theme).
  3. Create and specify any of the supported values inside the Theme key:
Note: You may need Administrator permissions to be able to modify system registry. If the IDE is open when you set or change registry values, you must restart the IDE for the values to take effect.

Reverting to Default Settings

To revert to the default settings, delete the Theme key from the registry. You can do it in either of the following ways:

Windows Registry Editor Version 5.00

[-HKEY_CURRENT_USER\Software\Embarcadero\BDS\20.0\Theme]
  • Delete the registry key Theme manually:
  1. Open system registry (type regedit into the searchbar on the Windows Start menu)
  2. Find the registry key HKEY_CURRENT_USER\Software\Embarcadero\BDS\20.0\Theme and delete it.

Customizable Values

Value Type Data
FontName String Specify the font name. The name is case sensitive and must not include the "subtype" such as Regular, Bold, Italic . For example, the name of the installed font is Lucida Console Regular. To choose it for the IDE, you must specify Lucida Console as the registry value. Default font of the IDE is Segoe UI.
Note: If you specify a wrong font name, the default font is loaded.
FontSize DWORD Specify the size of the font for the IDE. We recommend that you set it between 7 an 17 (values smaller or bigger can result in some IDE elements becoming unreadable). The default is 10.
Note: Do not forget to change the Base to Decimal when you modify the data of FontSize.
MainToolBarColor String The color of the main toolbar of the IDE. You can specify it in the following ways:
  • As a Hex value: For example, you can specify white color as $FFFFFF or as 0xFFFFFF.
  • Color name: see Color Constants for valid color names.

The default is clGradientActiveCaption.

Note: If you enter an incorrect value, the IDE does not start correctly (alerts saying that some packages cannot be loaded appear).

See Also