ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

New WINDEV Mobile 2024 feature!
Help / Editors / Window editor and page editor / Window editor
  • Overview
  • Characteristics of a bottom sliding window
  • Type of window
  • The different display modes
  • How to implement bottom sliding windows (bottom sheets)?
  • Creating internal windows
  • Configuring the bottom sliding window associated with a window
  • Programming bottom sliding windows
  • Displaying the bottom sliding window
  • WLanguage properties for manipulating bottom sliding windows
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
Bottom sliding windows (commonly known as "bottom sheets") are increasingly used in mobile applications.
This type of window has the following characteristics:
  • It appears from the bottom of the screen.
  • It can be modal or modeless.
  • It has 4 display modes: hidden, collapsed, half-expanded and expanded. Depending on the mode used, the sliding window partially or completely covers the host window.
This type of window is commonly used to open a menu, or to display additional data related to the host window.
Characteristics of a bottom sliding window

Type of window

There are two types of window:
  • Modal bottom sliding window:
    Modal bottom sliding windows offer users a range of options, but prevent them from interacting with the rest of the screen. They provide an alternative to menus and dialog boxes by offering additional space for content and actions.
    The host window is grayed out.
    The bottom sliding window disappears when the users taps anywhere else.
  • Persistent bottom sliding window:
    Persistent bottom sliding windows contain interactive elements, but also allow users to view and interact with the host window.

    They are commonly used:
    • to offer a feature or secondary content,
    • to provide additional information about the content displayed in the host window.
The different display modes
Several display modes are available:
  • Hidden: The bottom sliding window is not shown on screen.
  • Collapsed display mode: Only the content at the top of the sliding window is shown at the bottom of the host window.
  • Half-expanded display mode: Most of the content is shown on screen. Generally, this mode takes up half of the host window.
  • Expanded display mode: The bottom sliding window takes up the entire screen or most of it, hiding the contents of the host window.
Users can switch from one display mode to another by dragging the bottom sliding window up or down.
Collapsed
Half-expanded
Expanded
How to implement bottom sliding windows (bottom sheets)?
Below are the steps to implement bottom sliding windows:
  1. Creating internal windows. These internal windows will be the sliding windows.
  2. Configuring the sliding windows in the description of the main window.
  3. Defining the display mode of sliding windows:
    • using a swipe gesture (default: swipe up from the bottom edge of the screen to open the sliding window).
    • programmatically.

Creating internal windows

The sliding windows are internal windows.
This internal window has the following characteristics:
  • When used in the bottom sliding window or in the main window, Close will close both windows.
  • The controls of the bottom sliding window can be accessed via the main window, using the MyBottomSlidingWindow keyword:
    // Changes the color of a text in the bottom sliding window
    MyBottomSlidingWindow.STC_Caption.Color = LightRed
  • Sliding window appearance:
    To apply the color and border defined by the internal window, uncheck "System appearance (corners, shadow, etc.)".
  • To display more or less detailed information in the various display modes of the bottom sliding window, it is recommended to define several layouts in the internal window. Each layout should correspond to a display mode.

Configuring the bottom sliding window associated with a window

To configure the sliding windows associated with a window:
  1. Go to the "Details" tab of the main window description.
  2. Select the internal window to be used as a bottom sliding window:
    • In "Bottom sliding window (Bottom sheet)", specify:
      • the internal window to be displayed.
        Expand the list to see the available internal windows of the application
.
  • the appearance of the internal window.
    If "System appearance (corners, shadow, etc.)" is checked, the sliding window will match the style defined by the system. If this option is unchecked, you will be able to integrate a custom border directly into the internal window.
  • whether the sliding window is modal or modeless. If the sliding window is modeless, you can allow or prevent users from closing the window. In this case, users will be able to hide the entire window.
  • the different heights of the bottom sliding window:
    • Expanded height: Maximum height of the bottom sliding window.
    • Half-expanded height: Height of the half-expanded display mode.
    • Collapsed height: Minimum height.
  • These different heights can be specified as a percentage of the screen height, or in pixels. You can also choose a preset value.
    To disable a display mode, set the height to 0, or select the "Mode disabled" preset option. The anchors defined in the internal window will be applied.
  1. Validate.
Programming bottom sliding windows

Displaying the bottom sliding window

To be used, bottom sliding windows must first be visible.
You can set the visibility of bottom sliding windows:
  • using the options defined in the description of the host window.
  • programmatically, with the WinSlidingVisible function.
WinSlidingVisible can also be used to specify the display mode of the bottom sliding window.

WLanguage properties for manipulating bottom sliding windows

The MyBottomSlidingWindow keyword is used to manipulate the bottom sliding window associated with the current window.
The following properties are used to manipulate bottom sliding windows:
New in version 2024
HeightCollapsed
The HeightCollapsed property gets and sets the "collapsed" height of the bottom sliding window associated with the current window.
New in version 2024
HeightExpanded
The HeightExpanded property gets and sets the "expanded" height of the bottom sliding window associated with the current window.
New in version 2024
HeightHalfExpanded
The HeightHalfExpanded property gets and sets the "half-expanded" height of the bottom sliding window associated with the current window.
New in version 2024
Hideable
The Hideable property determines if the user can close a bottom sliding window with a touch gesture.
New in version 2024
InternalWindow
The InternalWindow property gets and sets the internal window contained in the bottom sliding window associated with the current window.
New in version 2024
Modal
The Modal property determines whether the bottom sliding window associated with the current current window is modal or modeless.
New in version 2024
RoundedCorner
The RoundedCorner property allows you to determine whether the bottom sliding window associated with the current window has rounded corners.
Minimum version required
  • Version 2024
Comments
Click [Add] to post a comment

Last update: 04/05/2024

Send a report | Local help