To Add a SideBar Menu in RFgen 5.2.4.0 to 5.2.4.2

The SideBar menu is a menu of device actions, (not a list of applications) which is launched from an icon or link from the application Form Heading.

There are three phases for creating and add the SideBar menu:

A. Choose menu actions for your SideBar.

B. In Themes > [name of your theme file] > SideBar: Set Active to True, set AutoHide to True or False, and select a DocMode. Set other appearance values as needed.

C. Add an icon or link to launch the SideBar from the Form Heading. Or to default the launch icon, set the SideBar launch icon in Themes > Applications > SystemIcons.

D. Optional: To script sidebar actions, refer to the MenuStrip Extensions in the Developers Reference Guide .

 

A. Choose menu actions for your SideBar

Select Configure > Menus and Keyboards.

In the System Menu Configuration box, add the specific actions and values you want to have on your SideBar.

For example, you can enable the user to:

  • Display a keyboard
  • Exit the application
  • Open Configuration Settings
  • Scan a barcode
  • Take a picture

Note: If displaying a keyboard, this toggles the active prompt's internal flag on whether the keyboard should be visible or not.

  • Action is the system event that is triggered when the user taps the text link and/or icon.
  • Text ID labels the action item. Its resourced from Solution Explorer > Text Resources. If you do not want a text label to appear on the SideBar, remove the Text_ID and Display Text from Text Resources. If you want a translatable label, select the Search icon from the Text_ID drop down and the Display Text cell should be filled in. If you want a label that is not linked to Text Resources, leave the Text ID blank, and enter your label in the Display text column.
  • Display Text is populated from the value assigned to the Text ID in Text Resources.
  • Object Name is used for passing an action to the Form_OnMenu event.
  • Image assigns the icon resourced from Solution Explorer > Images. The image you select here will be the icon that appear on the SideBar.
  •  

    • B. Set SideBar docking location and appearance

    Under Solution Explorer > Themes > SideBar set the default behavior such as where the SideBar will appear (docked).

    Use the properties here to also control how each icon or link looks and the background colors/borders for the SideBar.

     

    C. Add the icon or link to the Form Heading.

    See the topic, To Add an Icon to the Form Heading.