Please enable JavaScript to view this site.

R:BASE 11 Help

Navigation: How To (Forms, Reports, and more) > Forms > Form Designer > Form Controls > Additional Controls > Tile Menu

Action Bar

Scroll Prev Top Next More

An Action Bar extends the Tile Menu control with an additional context-specific functionality, similar to context menus in toolbar/menu systems. The functionality is provided via click-able items (also called action buttons) that reside within tile action bars in one row. End-users can click or tap these buttons in order to activate their functionality.

 

Linking Tiles and Action Bar Items

The "Linked To Tile IDs" setting is the key field to link an Action Bar Item to one or more tiles, based upon Tile IDs. If no value is specified, the Action Bar Item will appears for all tiles. To specify several tiles, enter the Tile ID list values as a comma separated string. This method requires no coding. For example, an Action Bar Item may be expected to appear for only tiles relating to a customer data tile group. In the properties for the Action Bar Item, the "Linked To Tile IDs" field would include a list (comma separated) of all Tile IDs for the customer tiles.

 

To perform ID and Action Bar Item linking manually through code, the PROPERTY command is used within the On Tile Check EEP to gather the list of checked tiles, then specify which Action Bar Item are to be displayed/hidden. To specify that all Action Bar Items be displayed, use the asterisk (*).

 

Example:

-- Captures the list of checked tiles

PROPERTY TileMenu1 CHECKEDTILES 'vTileIDs'

IF vTileIDs IN ('Customer,Contact,Employee') THEN

PROPERTY TileMenu1 SHOWACTIONBARITEM 'Add,Edit,Print'

PROPERTY TileMenu1 HIDEACTIONBARITEM 'Maintenance,Tools'

ENDIF

 

ð Title

Color

Specifies the background color of action bars

Indent (H, V)

Specifies the space (in pixels) between the left and right edges of an action bar and its visible items, and the space between the top and bottom edges of an action bar and its visible items

Item Indent

Specifies the space between visible action bar items, in pixels

Font

Specifies the font style, size, and color for action bar items

Persist Bar On Action Click

Specifies the action bar to remain displayed after an action bar item is clicked

 

ð Items

New

Adds a new action bar item

Edit

Edits the currently selected action bar item

Delete

Deletes the currently selected action bar item

 

The Action Bar Item display sequence can be reordered by selecting the green up and down arrow buttons.

 

ð Action Bar Item Properties

Action ID

Specifies an identifier for the action bar item. Action IDs can also be specified (within a comma separated string) to be displayed/hidden when a tile a tile is checked.

Caption

Specifies the action bar item's caption

Align

Specifies how the action bar item is horizontally arranged within its action bar

Position

Specifies the display position of the action bar item

Glyph

Specifies the action bar item's glyph.

Glyph Type

Specifies whether the state images are final images or transparency masks

Linked To Tile IDs

Specifies the Tile IDs (comma separated values) linked to the Action Bar item. The specified list deems which Action Bar items are displayed within the Action Bar when a tile is checked (selected). If no value is specified, the Item appears for all tiles.

Visible

Specifies if the action bar item is displayed

 

TileMenu_ActionBar_Prop

 

ð On Click

Clicking on the action bar item will run the specified EEP

 

To load a pre-existing EEP file, select the "..." button.

In

Specifies a command block to run within a procedure file

Edit...

Opens the R:BASE Editor to create/edit an external EEP file

Edit Custom EEP...

Opens the R:BASE Editor to create/edit a custom EEP that is stored within the form

 

 

 

See also:

 

Form EEP Information

How to Define Form EEPs

TileMenu_ActionBar_EEPs

 

 

TileMenu_ActionBar