QM™ GUI Style

You can also customize QM™ by changing the overall style of the GUI by means of the View->Style sub-menu. The available styles are shown below.

Attention: The selected GUI style is loaded only during the startup, so you need to restart QM™ for the GUI style to take effect.

The View|Style-menu allows you to achieve different effects, such as the "Default" (light) style and the "Dark" style shown below:

QM™ Style Sheet qm.qss

The QM™ Style Sheet qm.qss located in the Resources sub-directory of the QM™ Installation Folder provides the main way of customizing QM™. The Style Sheet takes advantage of the Qt Style Sheets, a mechanism inspired by HTML CSS (Cascading Style Sheets).

Remarks: The Resources folder contains the active style sheet qm.qss as well as example style sheets for the "light theme" (qm_light.qss) and "dark theme" (qm_dark.qss). To apply one of these example style sheets, simply copy them over the active style sheet qm.qss.

Note: If QM™ is installed on Windows in such locations as "Program Files" or "Program Files (x86)", the qm.qss style sheet might not be editable or accessible to QM™ (because Windows treats these folders specially). In this case it is recommended to re-install QM in a different folder, for example: C:\qp\qm.

Attention: The QM™ Style Sheet is loaded only during the startup, so you need to restart QM™ for the style sheet to take effect.

The active QM Style Sheet qm.qss is a plain text file that you can edit with any text editor. The Style Sheet contains several commented sections described below:

MainWindow Section

/* MainWindow ................................................................
*/
MainWindow {
    /* window background for code, doc and diagram widnows
    * (outside the editing area or canvas area)
    */
    qproperty-windowColor:       darkGray;
 
    /* background for code edit area */
    qproperty-codeBaseColor:     white;
 
    /* background for doc edit area */
    qproperty-docBaseColor:      #FFFFDD; /* light yellow */
 
    /* syntax highlighting styles */
    qproperty-comment: "green, #F7F7F7, italic";
    qproperty-keyword: "blue, transparent, bold";
    qproperty-preproc: "red,  transparent, bold";
    qproperty-string:  "darkBlue, transparent, italic";
    qproperty-string2: "blue, transparent, italic";
    qproperty-trail:   "transparent, lightGray";
    qproperty-stdint:  "blue, #EEEEEE";
    qproperty-me_ptr:  "red,  yellow";
    qproperty-evt_ptr: "blue, yellow";
    qproperty-qp_api:  "red, transparent, underline";
    qproperty-qm_dir:  "red, yellow, bold, underline";
}

ExplorerView Section

The ExplorerView section of the qm.qss Style Sheet pertains to Model Explorer.

/* ExplorerView ..............................................................
*/
ExplorerView {
    color:                       black;
    background-color:            white;
    alternate-background-color:  #E0E0E0;
}
ExplorerView:hover {
    background-color:            #FFFFDD;
    alternate-background-color:  #EEEEDD;
}
ExplorerView::item:selected {
    background-color:            darkRed;
}

SearchView Section

The SearchView section pertains to all Model Search.

/* SearchView ................................................................
*/
SearchView {
    font-style:                  italic;
    color:                       blue;
    background-color:            lightBlue;
    alternate-background-color:  #EEEEFF;
}
SearchView:hover {
    background-color:            #DDDDFF;
    alternate-background-color:  #BBBBEE;
}
SearchView::item:selected {
    background-color:            darkBlue;
}

DiagramView Section

The DiagramView section pertains to all Diagrams and the Bird's Eye View.

DiagramView {
    font-family:                 "Arial";
    font-size:                   8pt;
 
    qproperty-canvasColor:       white;
    qproperty-birdsEyeViewColor: #FFFF77;
    qproperty-nodePenColor:      darkBlue;
    qproperty-nodeBrushColor:    #E0E0FF;
    qproperty-connPenColor:      darkRed;
}

Diagram Styles

Bird's Eye Styles

CodeEdit Section

The CodeEdit section pertains to all code editors in the QM user interface, which include files and action editors in the Property Editor. The styles for the Working with Code Editors section come in two variants: when the Code window is active and when it is inactive.

/* CodeEdit ..................................................................
* Used in the files and code entered via a Property Sheet.
*/
CodeEdit {
    font-family:                 "Consolas";
    font-size:                   8.75pt;
 
    color:                       black;
    selection-color:             white;
    selection-background-color:  darkBlue;
    /* NOTE: set the background with MainWindow::qproperty-codeBaseColor */
}

Code Edit Styles (Code Edit Active)

Code Edit Styles (Code Edit Inactive)

DocEdit Section

The DocEdit section pertains to all documentation editors in Property Editor.

/* DocEdit ...................................................................
* Used in the documentation entered via a Property Sheet.
*/
DocEdit {
    font-family:                 "Consolas";
    font-size:                   8.75pt;
    font-style:                  italic;
 
    color:                       darkBlue;
    /* NOTE: set the background with MainWindow::qproperty-docBaseColor */
}

Log Section

The Log section pertains to the Log Console. The styles for the log come in two variants: when the log window is active and when it is inactive.

Log {
    font-family:                 "Lucida Console";
    font-size:                   8pt;
    selection-color:             darkRed;
    selection-background-color:  yellow;
}
Log:!active {
    selection-color:             white;
    selection-background-color:  darkGrey;
}

Log Styles (Log Window Active)

Log Styles (Log Window Inactive)

Model Templates

QM™ model templates are simply QM™ models, perhaps incomplete, which are intended to be elaborated further into complete QM models. Simple model templates are provided in the QM™ Installation Folder in the subdirectory Resources/, but you can easily add your own model templates.

Using the Templates

Model templates are used through the New Model Dialog Box, where you can select a model template on which to base your newly created model.

Adding New Templates

You add a new model template simply by saving a model in the QM Installation Folder (<qm>) in the subdirectory Resources/<qp-framework-type>, where <qp-framework-type> stands for the framework type of the saved model. For example:

A model template created with the QP/C framework should go into the directory <qm>/Resources/qpc.
A model template created with the QP/C++ framework should go into the directory <qm>/Resources/qpcpp.
A model template created with the QP-nano framework should go into the directory <qm>/Resources/qpn.

Note: If you save a model template for the wrong QP framework type (e.g., you save a model based on qpc into Resources/qpcpp/), the template will be rejected during creation of the new model.

Next: Basic Modeling

Table of Contents