Zamae

The Prosciutto Project

a small footprint mobile application engine and browser - and open source!

SCROLLBARS

Scrollbars are good to indicate the user that a form has several pages to go. Scrollbars are defined per form, and the UID of a scrollbar MUST match that of the form that it belongs to. ZAMAE will only display the corresponding scrollbar if it decides that pagination is needed for the specific form and device it is running on.

All attributes except the UID are optional, but we strongly recommend that you specify your own settings, as the default values might not be the best fit for your application.

Also, the scrollbars should have the same look and feel throughout all forms in the same application. Note that this is only a recommendation, you can always define each unique scrollbar to look like whatever you want to.

Please note also that ZAMAE default cache memory is up to 10 different scrollbars at a time. As scrollbars are uniquely defined and attached to the corresponding form, the quantity of allowed scrollbars in memory at any given time matches that of the forms cache, which is 10 by default. This can be modified by placing the values you need in the za_UI_api.initialize() call in the class of your own that extends the za_UI_api class. Note that if you change the amount of forms, the memory footprint required by ZAMAE to run might substantially change.

    <scrollbar uid="13000" >                         
        <anchor>right</anchor>                  //anchor. Bottom and Top make the scrollbar horizontal.  Left and Right make the scrollbar vertical.          
        <color_id>69012</color_id>              //color definition for scrollbar. Mandatory.                      
        <x_coord>undef</x_coord>                //x coordinate for scrollbar. Default to "undef" or abscent.
        <y_coord>undef</y_coord>                //y coordinate for scrollbar. Default to "undef" or abscent.
        <height>undef</height>                  //scrollbar height. Default to "undef" (as high as the screen size minus the space used by templates in a given form)
        <width>6</width>                        //scrollbar width. Default "undef" (6 pixels) or abscent
        <min>undef</min>                        //scrollbar min value. Default "undef" or abscent. Indicates which value it should represent.
        <max>undef</max>                        //scrollbar max value. Default "undef" or abscent. Indicates which value it should represent.
        <start_at>undef</start_at>              //scrollbar starting value. Default "undef" or abscent. Indicates which value it should represent when first displayed.
    </scrollbar>

    

Back to UI objects listing