Menu

Description:

Horizontal menu bar that is presented at the top of the screen. Through this object, the following sub items can be presented:

• Categories: These are the items, the end user can select from a pulldown (when the category is in the top menu bar) or popup list (when it is in any lower level) to get a more detailed list with sub categories, separators and/ or trigger items. If a category does not contain any sub categories, separators or trigger items then it will always appear disabled.
• Separators: These are horizontal separation lines that can be added to a pulldown or popup list or to the menu bar itself. Separators can not be selected at runtime. This also means that these can never be triggered.
• Trigger items: These are the items, the end user can select from the top menu bar, pulldown or a popup list to run the function that is programmed for the OnMenuSelect event.

The size of the menu depends on the chosen font and the content of the menu. Because the content of a menu can be changed dynamically, the menu size could change at runtime.

Only 1 menu per form is allowed.

A separator can be added in a submenu by adding a normal Item in the Object inspector and then setting the Caption of the added item to a single minus sign '-'. The added item will then transform into a separator.

When in the top menu a separator can be added by adding a normal Item in the Object inspector and then setting the caption to a vertical bar '|'.

 

Toolbar button icon:

 

Properties:

• 3D
• Color
• ColorFontDisabled
• ColorFontSelected
• ColorSelected
• ColorShadow
• ColorShadowBright
• ColorShadowDark
• Description
• Enabled
• Font
• HelpText
• MenuItems
• Name
• Parent
• TabNumber
• Tabstop
• Visible

 

Dynamic properties:

• Color
• Enabled
• FontBold
• FontColor
• FontItalic
• FontName
• FontSize
• FontUnderline
• Helptext
• Items
• Visible
• Items[<Row number>].Category
• Items[<Row number>].Enabled
• Items[<Row number>].Name
• Items[<Row number>].Shortcut
• Items[<Row number>].SubCount
• Items[<Row number>].SubIndex
• Items[<Row number>].Value
• Items[<Row number>].Visible

 

Events:

• OnMenuSelect

 

Functions:

• Items.Add()
• Items.Clear
• Items.Count()
• Items.Delete(<Row number>)
• Items.IndexByName(<Item name>)
• Setfocus