Menu for Smart Devices object

Official Content
This documentation is valid for:

A Menu for Smart Devices is usually the entry point of a Smart Device application. It displays a set of items the user may choose from, for example, it may display items such as Work With for Smart Devices object, Panel for Smart Devices object, Menus, links to web pages or actions like making a phone call or sending an email.

You can create a Menu for Smart Devices from the New Object dialog of GeneXus:

New Object - Menu for Smart Devices 

Object properties

Remarkable properties of Menu for Smart Devices object are listed below.

Once a Menu for Smart Devices has been created it will have a tree-like interface where you can add the items you wish to be displayed on it, and adjust their properties to your needs.
Menu for Smart Devices - Items tree

Menu node properties

Selecting the 'Menu' item on the tree, there are the following properties available.

  • Title property
    Title for this Menu
  • Background property
    Menu background image. It must be an Image object.
  • Header property
    Menu header image. It must be an Image object.
  • Class property
    Menu theme-class.
  • Control property
    Can be List, Tab, or Table.
  • Tabs Distribution property
    Only visible when Control property value is Tabs. Indicates how the Tab options will be distributed in the Tab control for the Menu. Possible values are:  Platform Default, Fixed Size and Scroll. The 
    Fixed Size value applies when the control has few options (at most five), in that case each of them have the same width in the Tab control. On the other hand, the Scroll value put each option with the needed width depending of the image and caption. This option allows scrolling the tab control when the number of options exceeds the width of the screen.
    Applies only for Android, Tab control in Menu for Smart Devices always behave as Fixed Size value for iOS applications.
  • Appearance group

Items node properties

The Items are the elements that will compose the Menu (generally Work With for Smart Devices associated to the Transaction object or SD Panels). To add new Items drag the object from the folder view and drop it in the Items node of the Menu. Also, you can right-click on Items node following by Add Action.


Each Item has the following properties.

  • Name property
    Name of the option. With this name will be referred its action on the Event tab.
  • Description property
    Description of the option. If its value is empty, the property name will be is used. If you want an empty description on the Menu, it is needed to add a blank space in the property.
  • Image property
    An icon used for the option. It must be an Image object. If Control property for Menu node is set to Tabs, iOS and Android require the image file format to be PNG and only its transparency will be taken into account.
  • Class property
    MenuItem theme-class used for the option.


Menu - Control type - Example 1  Menu - Control type - Example 2  Menu - Control type - Example 3


  • (1) Deprecated as of Genexus 15 Upgrade 10 (no longer available).
  • As of GeneXus 16 upgrade 2, when using Tab control for Menu options, the ActivePageChanged event and Menu.ActivePage property are available to be used in the object events.

See also


Start Video Overview of the development of GeneXus applications for smart devices (part 3 1:50)

Subcribe to this category's changes
Sub CategoriesAdd a new subcategory in this category
PagesAdd a new page in this category