# Menu Bar

Menu Colors |

(NOMADS Only)

In NOMADS, color can be applied to three areas of a menu: the text color, the background color and the left edge portion of the menu. Colors for the menu can be set by a number of different ways: %NOMADS Properties, Library Default settings, Menu Bar Definition settings, Themes Maintenance, and Visual Classes Maintenance.

For information on how these various settings work in conjunction with each other, see Menu Color Hierarchy.

(The Menu Color hierarchy was added in PxPlus 2024.)

#### Note:
Menu settings are not applicable to iNomads.

The text and background of an individual menu entry (item, group and link) can also be defined. Colors for a specific item in the menu can be set in the Menu Bar definition.

Settings for color can comprise System Default, dependent on %NOMADS properties, Library Default settings, Themes and Visual Classes and determined by the Menu Color hierarchy, or specific colors, as described in the following table. See Color Selections.

The color format may be one of the following:

Color Format | Description
Predefined System Color | Dark Gray, Black, Dark Red, Light Red, Dark Green, Light Green, Dark Yellow, Light Yellow, Dark Blue, Light Blue, Dark Magenta, Light Magenta, Dark Cyan, Light Cyan, Light Gray, White
Custom RGB Setting | In the format RGB: nnn Where: n can be 0 to 255. Click on the Color lookup button to select colors from the system color palette or define custom colors.
HTML Hex Color Codes | HTML color codes (search Internet) Example: #FF0080
User-Defined Color | In the format "Colorn" Where: n can be 16 to 255. See User Defined Colors.
Expression | String expression that evaluates to a color setting, such as a predefined system color, RGB setting, HTML Hex color code, or user defined color.
One of the Special Color Options | System Default is the Windows system color. Menu Default indicates use of the default color settings for the entire menu.

If no left edge color is defined, the system will apply the background color (right/text side) to the left edge of the menu. Only the left edge color applies to the entire menu. The text background color can be set on individual menu entries for an item, group or link.

The option to apply the text and background to the top level of a menu bar is also provided.

## Menu Color Hierarchy

(NOMADS Only)

This table explains the different methods that can be used to set menu colors and their order of precedence:

Method to Set Menu Colors | Description
%NOMADS Properties | These four %NOMADS properties can be used to set the system-wide defaults for the menu: %NOMADS'Menu_Text_Clr$ %NOMADS'Menu_TextBackground_Clr$ %NOMADS'Menu_LeftEdge_Clr$ %NOMADS'Menu_Top_Option$ If not set, the defaults are Black text on a White background.
Library Defaults | Menu colors can be set at the Library level in Library Defaults on the Font/Color tab. The Library Default setting will override the system-wide settings.
Menu Bar Definition (entire menu) | Menu colors for the entire menu can be set in the Define Menu Colors dialogue, which is invoked from the Menu Bar definition. If set, these colors will override both the Library and the system-wide settings.
Menu Bar Definition (individual item) | Background and Text colors can be set for individual menu items, groups or links on the Attributes tab in the Item, Group or Link definition. If set, these colors will override all other Background and Text color settings, regardless of where they are set.
Theme | If a Theme is set, the Theme settings will override Library Defaults and the settings in the Menu_Bar definition, except for settings for individual menu items. They will also override the %NOMADS Properties settings unless any Theme settings are set to Default. Themes can have Menu_Bar and Popup_Menu definitions to determine Menu Background Color, Menu Left Edge Color, Menu Text Color, Hover Background Color and Hover Text Color. Menu_Bar definitions can also specify a Use Color on Top Level option. If a Theme is set that has no Menu_Bar or Popup_Menu definition, then the background and text color from the Theme's Default definition is used.
Visual Class | A Visual Class can be assigned in the Define Menu Colors dialogue, which is invoked from the Menu_Bar definition and the Popup_Menu definition. If a Visual Class is set, the Visual Class settings will override Theme settings, Library Defaults and settings in the Menu_Bar definition, except for settings for individual items. They will also override the %NOMADS Properties settings unless any Visual Class settings are set to Default. Visual Class definitions can have Menu_Bar and Popup_Menu definitions to determine Menu Background Color, Menu Left Edge Color, Menu Text Color, Hover Background Color and Hover Text Color. Menu_Bar definitions can also specify a Use Color on Top Level option. If a Visual Class is set that has no Menu_Bar or Popup_Menu definition, then the background and text color from the Visual Class's Default definition is used.