You are here:

MenuCommand

Form and theme XML code and CSS element selector

Most commonly used form and theme properties

MenuCommand is the actual menu option that can be invoked by the user.

Do not mix up menus created in Lycia Form Designer from MenuBars, MenuGroups, and MenuCommands, with menus created by the MENU statement.

Form XML code:

<MenuCommand.onInvoke>

</MenuCommand.onInvoke>

</MenuCommand>

Theme element filter XML code:

...

</ElementFilter>

CSS element selector code:

.qx-aum-menu-command

Inheritance diagram:

Most commonly used form properties:

Most commonly used theme properties:

Size

Image Id ↓

Associated 4gl syntax:

ON ACTION ↓

COMMAND

Associated ui methods:

Create ↓

ForName

SetText ↓

GetText

SetImageId ↓

GetImageId

SetShortCut ↓

GetShortCut

SetOnInvoke

GetOnInvoke

SetIsChecked

GetIsChecked

Influence and behavior:

Menus have a reserved place in a window. You cannot place a MenuCommand anywhere you want - you can only insert it to a MenuGroup.

To add a MenuCommand to your form,

Step 1. Choose a MenuCommand in the widgets palette by left-clicking its icon.

Step 2. Move the cursor and drop the MenuCommand to the selected MenuGroup.

Step 3. The MenuCommand is now added to your form, and you can see it in the Structure view.

You can add MenuCommands to MenuGroups or directly to a MenuBar.

Once added, you can move the menu commands between menu groups or change their order in a menu group:

Most commonly used form properties of a menu command are text, classnames, identifier, and onInvoke.

Here you can find out how to change the text of the menu command in Lycia Form Designer:

Here you can find out how to change the widget text at runtime using ui methods.

To allow user communication with your menu commands, you must set actions to them using ON ACTION or COMMAND clauses:

ON ACTION "act1"

DISPLAY "This action was triggered by the menu command 'One'."

...

END MENU

Try the example programs - menucommand and menu - to learn more about working with menu commands.

At runtime, you create and manipulate menu commands with ui methods.

To create a menu command,

You can also use ui methods to change properties of a menu command:

CALL menucommand.setText("My new command")

CALL menucommand.SetImageId("qx://application/bookmark.svg")

CALL menucommand.SetShortCut("F2")

Try the example programs - menucommand_ui and menu_ui - to learn how to create dynamic menus at runtime.

You can change the appearance of a menu command master and user themes and/or css styles.

property applied in the user theme:

theme XML code:

<?xml version="1.0" encoding="utf-8"?>

<PropertyName>Background</PropertyName>

<PropertyName>FillColor</PropertyName>

</PropertyPath>

</SetProperty>

</DoStyleAction>

</StyleSheet>

</ElementFilter>

</StyleSheet>

css code:

.qx-aum-menu-command {

background-color: teal;

}

runtime appearance: