peActionDisplay - cWebMenuItem

Determines where the menu item will appear

Type: Property (Web Property)

Access: Read/Write

Data Type: Integer

Parameters: None

Syntax
 { WebProperty=Client }
 Property Integer peActionDisplay

Web Property Read Access: WebGet peActionDisplay to IntegerVariable
Web Property Write Access: WebSet peActionDisplay to IntegerVariable/Value

Read Access: Get peActionDisplay to IntegerVariable
Write Access: Set peActionDisplay to IntegerVariable/Value


Description

Determines where the menu item will appear.

Possible values:

ConstantMeaning
adMenuwill only appear in the drop down menu
adActionBarwill only appear in the action bar
adBoth(default) will appear in both the action bar and the menu



Working with Action Menus

Action menus are the menus that appear in the top right corner of the header bar in a touch/mobile application. These menu items may appear as a button in a menu bar and/or they may appear in a drop down menu that is accessed by pressing the "more options" icon. The actual menu bar control is created in your cWebApp object using the cWebActionBar class. This object does not contain menu items. Each view defines items for this menu by defining a cWebMenuGroup within the view object. This object will contain menu items. When the view is displayed, the menu items for this view are displayed by the cWebActionBar control. This allows all views to share the same action bar menu, but show custom menu items for each view.

Each menu item within a cWebMenuGroup is a standard cWebMenuItem. When a cWebMenuItem is used within an action group, the peActionDisplay property determines where the menu item will appear.

The width of the action bar menu is determined by the piWidth web property. When the desired menu items do not all fit in the action bar, the extra items will be added to the drop down menu.

Normally, action bar items are displayed as an icon. This can be changed with the pbShowCaption and pbShowIcons properties.

It is expected that the menu items appearing in an action bar view will change based on how the view is being used. You can hide or disable menu items using the pbRender and pbEnabled web properties. With mobile applications, it makes the most sense to hide the menu items you do not need. When navigating forward in a view, you will probably want to hide/show the menu items needed for this particular usage of the view.


About Web Properties
Each web property maintains two values: The regular property value is set during object creation and should not be changed during the lifetime of that object. To access that value, use the standard property Get and Set syntax.
The web property value is the local value stored at each client. This is synchronized to the client's local value whenever a server call is being processed. To access the web property value, use the WebGet and WebSet syntax above instead of the standard Get and Set syntax.