

The state Disabled is true for every not available scrollbar (the property Enabled of the scrollbar is false). You can imagine, in the Active state, the user interacts with the scrollbar. The state Active is true, if the user actively touches the scrollbar's thumb. This is also the case if the scrollbar has been configured as a passive widget not intended to handle any user inputs.

The state Default determines a scrollbar, which is ready to be touched by the user. The following table provides an overview of all Horizontal Scrollbar states: Understanding these states is especially essential when you intend to customize your own individual Horizontal Scrollbar. While the user interacts with the widget, the scrollbar switches between the states fourth and back. Understand the states of the Horizontal Scrollbarĭuring its life time, the Horizontal Scrollbar remains always in one of its three possible states. Once your configuration object is available, you can select it in the property Appearance exactly as you select one of the configurations provided per default with Embedded Wizard. If you prefer to adapt the appearance of the Horizontal Scrollbar by yourself, then you have to create a new Horizontal Scrollbar Config object and specify in it all the bitmaps, colors as well as other parameters to customize your individual Horizontal Scrollbar. If you like the provided default configurations then you can use them as they are: You can use the integrated Inspector Assistant window to conveniently select the right configuration. To use the desired appearance configuration you have to select it in the property Appearance of the affected Horizontal Scrollbar widget as demonstrated in the screenshot below. These are not interactive and they are configured to automatically disappear when not needed. The second set (called Mini) presents a thinner variant of the scrollbars. The user can touch and drag their thumbs. The first set is predestined to be used wherever you need an interactive scrollbar.

The configurations are divided in two sets, every with three sizes small, medium and large. The following figure demonstrates all available default configurations at once: For demonstration purpose and to help you to quickly create new product prototypes, Embedded Wizard contains six ready to use configurations you can use instantly. The appearance and partially also the behavior of the Horizontal Scrollbar widget can be configured according to your particular design expectation. Select the appearance for the Horizontal Scrollbar For the complete reference please see the documentation of the WidgetSet::HorizontalScrollbar and WidgetSet::HorizontalScrollbarConfig classes.
#HORIZONTAL SCROLL BAR AQUAMACS HOW TO#
The following sections are intended to provide you an introduction and useful tips of how to work with and how to customize the Horizontal Scrollbars. The following screenshot demonstrates few examples of how Horizontal Scrollbars appear in the canvas area of Composer (and accordingly on the screen in your target device): However, if desired, you can create your own configuration objects and so customize the Horizontal Scrollbar widgets according to your particular design expectations. Embedded Wizard is delivered with a set of prepared Horizontal Scrollbar Config objects you can use instantly as they are. This configuration object provides bitmaps, colors and other configuration parameters needed to construct and display the affected Horizontal Scrollbar. The exact appearance and behavior of the Horizontal Scrollbar is determined by a Horizontal Scrollbar Config object. if the content is already entirely visible so the user has nothing to scroll. Scrollbars can also be configured to disappear automatically when these are not needed, e.g. To allow the user to scroll the contents another technique (for example the Slide Touch Handler or Key Press Handler) has to be used. Such configured scrollbars are predestined to only show to the user the current position within the scrolled content. If desired, the scrollbars can also be configured to act as pure passive widgets which then ignore any touch events. Controlling the scrollbars via keyboard or hardware buttons is not intended. Each time the user interacts with a Horizontal Scrollbar, the widget sends signals to associated slot methods where your particular implementation is executed. This widget can be used to compose the appearance of other more complex GUI components, in particular to add to them controls intended to show the horizontal scroll position and the width of the actually visible area ( view) within the body of a large document ( content). The Mosaic class WidgetSet::HorizontalScrollbar implements a GUI component intended to serve as a Horizontal Scrollbar widget.
