SystemTheme.qxtheme

 

SystemTheme.qxtheme is a system theme file that specifies basic parameters of all applications developed, deployed, and run via Lycia.

SystemTheme.qxtheme is overwritten by master themes and user themes as well as master and user styles (.css).

 

SystemTheme.qxtheme is created during Lycia installation.

 

By default, SystemTheme.qxtheme is located in

C:\Program Files\Querix\Lycia 3 Development Suite 7.1\Lycia\etc

/opt/Querix/Lycia/etс/

 

You can change the default location of SystemTheme.qxtheme by setting the corresponding environment variable:

 

LYCIA_SYSTEM_THEME_QX=C:\Users\my_user\my_lycia\my_system_files\my_system_theme.qxtheme

 

By default, SystemTheme.qxtheme has the following content:

 

 

Press » to see the default content of the file in the text form:

 

These properties are set by default:

 

element

filter

property

<all>

—

Enable Border

Report Viewer Config

—

Viewer Type

With ID

Viewer Type

Title Bar Options

—

Disable Title Bar Close Button

Disable Title Bar Maximize Button

Disable Title Bar Minimize Button

Hide Title Bar

Text Field

in Function Fields Abs

With class, Children

Is Password Mask

Application

—

Start Menu Shortcut

With class, Descendants

Apply class

With class

Full screen

Template Instance

for Status Bar in Application

Children

Template Name

Window

With class, With ID

Full screen

Template Instance

for Status Bar in Window

Children

Template Name

Table

—

Image Collapsed

Image Expanded

Indent

Tree Table

—

Image Collapsed

Image Expanded

Indent

Coord Panel

Children

Z Order

Table Column

With class

Visible

Text Field in Table Column

Children

Enable Border

Combo Box

With Pseudo-Class

Editable

<data widgets>

With Pseudo-Class

Is Password Mask

<printable widgets>

With Pseudo-Class

Apply class

Menu Group in Menu Bar

With class, Descendants

Image Id

Label

With Pseudo-Class

Margin

Image

<all>

With class

Horizontal alignment

Vertical alignment

 

As SystemTheme.qxtheme is one of the basic configuration files for Lycia, we do not recommend you to change this file unless you have a considerable experience of such modifications.

Otherwise, we cannot ensure proper runtime look and behavior of your applications.

 

If you need or wish to change the system theme file, you can follow this algorithm:

 

 

1

Copy the SystemTheme.qxtheme files with a new name, e.g., my_system_theme.qxtheme

2

Change and save this new system theme file - my_system_theme.qxtheme

3

Specify the new system theme file and its location as the value for LYCIA_SYSTEM_THEME_QX in inet.env and env.properties:

 

LYCIA_SYSTEM_THEME_QX=C:\Users\my_user\my_lycia\my_system_files\my_system_theme.qxtheme

 

 

In this case, you will be able to use the new system theme file according to your development and production needs AND will still keep the original SystemTheme.qxtheme file as a backup (and will be able to easily return to it if necessary).

 

If you have several projects and want them to look and behave in a certain manner or if you want your applications look and feel different when run with different AppServer instances,  you can follow this algorithm:

 

 

1

Create a new application server instance, e.g., eu_secure

2

Create a new inet.env file and specify this new inet.env file in the new application instance in listener.xml:

 

<name>eu_secure</name>

...

<envfile>C:\ProgramData\Querix\Lycia\eu\etc\eu_inet.env</envfile>

 

3

Copy the SystemTheme.qxtheme file with a new name, e.g., eu_system_theme.qxtheme

4

Change and save this new system theme file - eu_system_theme.qxtheme

5

Specify the new system theme file and its location as the value for LYCIA_SYSTEM_THEME_QX in the new inet.env file:

 

LYCIA_SYSTEM_THEME_QX=C:\Users\my_user\lycia\eu\system_files\eu_system_theme.qxtheme

 

 

You can open and modify SystemTheme.qxtheme in Lycia Theme Designer (recommended, opens by the double click on the file) or with your favorite text editor:

 

Step 1

Go to C:\Program Files\Querix\Lycia 3 Development Suite 7.1\Lycia\etc.

 

Step 2

Copy SystemTheme.qxtheme with a new name.

 

Step 3

Introduce the necessary changes to the copy and save it.

 

 

The syntax of SystemTheme.qxtheme is the same as of any other theme file in Lycia.

 

To get more details, you can go

§      here to read about the theme syntax and

§      here to learn how to work with Lycia Theme Designer.

 

Here you can watch a short video about how to work with Lycia Theme Designer.

 

 

Related articles:

Master and user themes

SystemTheme.css

Form, theme, and css property precedence

Lycia Theme Designer

LYCIA_SYSTEM_THEME_QX

Application server instances

inet.env

listener.xml