ButtonBar Layout

RhoElements 2.x API

Overview

A ButtonBar Layout is a collection of ButtonBars arranged in a single view. Layouts can be created using the ButtonBar Tool, a desktop utility for Windows. This API module is used to show/hide specified layouts created through the tool.

IMPORTANT:


Syntax

buttonBarLayout (Module) <META> Syntax

<META HTTP-Equiv="buttonBarLayout" content="[parameter]">

ButtonBarLayout JavaScript Object Syntax:
By default the JavaScript Object 'buttonBarLayout' will exist on the current page and can be used to interact directly with the buttonBarLayout.
To Invoke buttonBarLayout methods via JavaScript use the following syntax: ButtonBarLayout.property;

e.g. buttonBarLayout.enabled= "LayoutName";

e.g. buttonBarLayout.disabled= "LayoutName";

Properties

Items listed in this section indicate methods or in some cases parameters that can be retrieved.
NameDescriptionDefault Value
enabledShow the Layout with this nameN/A
disabledHide the layout with this nameN/A

Parameters

Items listed in this section indicate parameters or attributes that can be set.
Name Possible Values Description
enabled:[Value] ‘Layoutname’ Shows the layout with the specified name
disabled:[Value] ‘Layoutname’ Shows the layout with the specified name

Remarks

Screen Orientation

When the screen orientation changes, using either the ScreenOrientation tag or by rotating a device with hardware support, the buttons themselves do not move. In some cases, this results in layouts that appear partially off the screen or are not in the expected position. If so, Zebra recommends creating different layouts for portrait and landscape modes and switching to the appropriate layout by detecting the orientation with ScreenOrientationEvent.

Requirements

EnterpriseBrowser Version 2.0 or later
Supported devices All supported Android devices
Minimum Requirements None
Persistence Persistent - Changes to this module persist when navigating to a new page

HTML/JavaScript Examples

The following example demonstrates how to show the Layouts created through the ButtonBar Layout tool by injecting metatags into a page.

<META HTTP-Equiv="buttonBarLayout" Content="Disabled:qwertylayout">
<META HTTP-Equiv="buttonBarLayout" Content="Enabled:qwertylayout">

Alternatively a particular Layout can be shown on all pages of the application using the DefaultMetaTags tag in the Config.xml file without changing the server application code. Please include the following in the DefaultMetaTags section in the Config.xml.

<DefaultMetaTags>
    <MetaTag value=" buttonBarLayout~ enabled:numericlayout;"/>
    <MetaTag value=" buttonBarLayout~ disabled:numericlayout;"/>
</DefaultMetaTags>

The following example demonstrates how to show/hide the ButtonBar via JavaScriptable objects.

<script>
    function showbuttonbar()
    {
        buttonBarLayout.enabled= "LayoutName";
    }

    function hidebuttonbar()
    {
        buttonBarLayout.disabled= "LayoutName";
    }
</script>