ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Action Bar control
  • Overview of Action Bar
  • Creating and configuring an Action Bar
  • Bar style
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Overview of Action Bar
Action Bars replace the title bar of a window and display different types of information:
  • the application icon,
  • the window title,
  • some menu options,
  • the drop-down menu of your window.
Creating and configuring an Action Bar
By default, windows are created with an Action Bar.
You can configure the bars used in the window:
  1. Open the window description ("Description" in the context menu).
  2. In the "Style" tab, specify the content of the top bar:
    Choosing the top bar
    • Full screen: no bar is displayed,
    • System bar only: Only the system bar is displayed.
    • System bar + Action Bar: The system bar and the Action Bar are displayed.
    • Action Bar only: Only the Action Bar is displayed.
    • iPhone/iPad Page Sheet (iOS13 and later): if this type of bar is selected, the window can be opened from the bottom of the screen. The window is "cascaded": it doesn't completely cover the window underneath. It can be closed simply by swiping it down.
      If this option is selected:
      • the window has no bars in the editor.
      • the "Allow closing" event is automatically associated with the window. If this event returns:
        • True, the window is closed.
        • False, the window is reactivated.
      Remark: If this window is used in a version lower than iOS 13, the window is maximized and the close swipe has no effect.
Depending on the type of bar selected, the "Edit bar style" button allows you to set the style options used (color and font).
Remarks:
  • iPhone/iPad If you use the system bar, you can configure the system bar transparency on iOS 7 and later.
  • iPhone/iPad For iPhone X, you can shift the bars according to the sensor area.
  • Android Until version 25, the height of Action Bar controls is 48 px by default. Starting with new projects in version 26, the height of the Action Bar control is 56 px by default. You can choose the default height in the description window of the project configuration: Action bar height option in the "General" tab.
    Remark: If the height is changed, the new height is applied to all windows in the application.

Bar style

The "Edit bar style" button allows you to define the style options of the selected bars:
  • System bar.
  • Action Bar.
  • Navigation Bar.
Android If you use the system bar, you can configure:
  • the background color: this color can be:
    • a specific color, a system color or transparent.
      If the color is "Transparent", the color of the system bar is that of the Action Bar. This option is taken into account only if the window contains an Action Bar.
    • adapted to the Action Bar. In this case, if the "Material design" skin template is used, the system bar uses the same color as the Action Bar, with a darker tone. Otherwise, the color of the Action Bar is used.
  • the text color.
  • whether the bar should be in overlay mode. If the "Bar overlay" option is checked, the origin of the controls is modified and the Opacity property can be used on the Action Bar control. The bar will be displayed over the controls.
If you use the Action Bar, you can configure:
  • the background color: it can be a specific or automatic color.
  • Android the Action Bar shadow.
  • the font color.
  • whether the font color should be applied to the active icons.
  • the background image of the Action Bar.
  • if the bar should be displayed over the controls. If the "Bar overlay" option is checked, the origin of the controls is modified and the Opacity property can be used on the Action Bar control. The bar will be displayed over the controls.
If you use the navigation bar, you can configure the colors used for active and inactive elements.
Android Remarks:
  • This system bar color configuration is only available in Android 5.0 and later.
  • The bar color cannot be changed on Nexus devices.
  • Use the SystemBarColor property to programmatically change this color.
Related Examples:
WM ToDo List Cross-platform examples (WINDEV Mobile): WM ToDo List
[ + ] This example is a manager of To-Do Lists.
The project is using the gestures in the loopers in order to move and delete the lists and tasks.
The data is stored in a HFSQL database.
Minimum version required
  • Version 17
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/07/2023

Send a report | Local help