Stylus Scrolling

From Openmoko

Jump to: navigation, search

Contents

Overview

Stylus scrolling is a widget that provides more traditional window scrolling.

Usage Cases

Appearance & Interaction

image:Widget_stylus_scrolling.png

Arrows

on tap

  • scroll one unit

on tap with hold

  • continuous scrolling

Scroll Bar

on tap with hold

  • start dragging

Constraints

  • Never use a ScrollBar as a stand alone widget -- it is always attached to another widget.

Architectural Details

  • The scroll bar should be proportional to viewable area

UI Image Files

Download the UI images: click here

  • scroll_action_btn_down.png -- The scroll down button with normal state.
  • scroll_action_btn_down_p.png -- The scroll down button with tap state.
  • scroll_action_btn_up.png -- The scroll up button with normal state.
  • scroll_action_btn_up_p.png -- The scroll up button with tap state.
  • scroll_bg_bottom.png -- The bottom side background of the scroll bar.
  • scroll_bg_top.png -- The top side background of the scroll bar.
  • scroll_btn_bottom.png -- The bottom side of the scroll button.
  • scroll_btn_top.png -- The top side of the scroll button.
  • scroll_fullscreen_btn_off.png -- The fullscreen disable button with normal state.
  • scroll_fullscreen_btn_off_p.png -- The fullscreen disable button with tap state.
  • scroll_fullscreen_btn_on.png -- The fullscreen enable button with normal state.
  • scroll_fullscreen_btn_on_p.png -- The fullscreen enable button with tap state.

Implementation Recommendations

  • Where possible, use the built-in scrollbar handling by other widgets.
  • If you need scrollbars around custom widgets, you might want to derive from GtkScrolledWindow rathern than directly interacting with a GtkVScrollbar

Cross-Widget Interactions

  • Sends signals to attached widget.

Unresolved Issues

(TBD)

Questions and Answers

(None)

Personal tools