Home · All Classes · Main Classes · Deprecated |
A "common component" is a reusable element of the MeeGo Handset user interface. Typical components include the standard UI controls such as buttons, sliders, and lists, as well as the more complex dialogs and menus.
Components are also widgets (specifically QGraphicsWidgets) and can be used wherever widgets can be used. However, all widgets cannot be regarded as components due to some unique features that common components have.
Common components have the following features:
While applications are not usually created of only common components, use common components instead of custom controls where applicable to ensure that your application fits in with the rest of the MeeGo user experience. This also helps your users to transfer what they have learned from other MeeGo applications to your application.
Class: MButton
Buttons come in many form and sizes, but can fundamentally be divided into two main use cases: buttons that execute an action when pressed and buttons that maintain a toggle state (on/off).
The following button types are available:
Button
Icon button
Check box
Switch
Class: MList
List
Displays objects vertically. Use a list when there are numerous items or the items are subject to change. Otherwise consider using a layout instead.
A list can contain any type of QGraphicsWidget, but typically a MListItem is used.
Class: MTextEdit
Allows the user to input text. The edit include a single line or multiple lines, or it can expand if necessary. When a hardware keyboard is not available, the text edit interacts with the virtual on-screen input methods.
Class: MLabel
Displays text in the UI. The MeeGo Touch label supports both markup and links.
Class: MImageWidget
Represents a single picture in the UI.
Class: MVideoWidget
Supports flexible playback of video in the UI. The widget can, for example, be rotated along with the rest of the UI and have transparent controls overlaid.
Class: MApplicationPage
Provides one view of an application. You can typically navigate inside the application by switching between multiple pages.
Class: MApplicationMenu
Application menu
Is typically not directly accessible. Instead, actions are added to an MApplicationPage. This allows the menu to be reconfigured automatically as the user switches between pages in the application.
The application menu consists of a list of commands related to the current application view or the entire application.
Class: MDialog
Dialog
Requires a response from the user and blocks access to the rest of the application. Unlike notifications, dialogs do not disappear from the UI without user interaction.
Object menu
Lists contextual actions that can be performed on a certain object. The object menu is automatically constructed by the MeeGo Touch framework when the tap and hold gesture is used on a widget. The menu consists of the QActions and MActions added to the widget.
Tool bar in landscape
Tool bar in portrait
Tool bar lists the most important actions for the current application page/view. The tool bar is reconfigured automatically when actions are added to the currently active page.
Tab bar is an alternative way of providing navigation inside an application. A tab bar provides direct access to the most commonly used UI views.
Class: MSlider
Slider
Allows the user to select from a range of values.
Class: MSeekbar
Seek bar
Displays the amount of currently loaded content in a set value range. The seek bar is a specialised version of the slider.
Class: MCombobox
Combo box
Opened combo box
Allows the user to select a value from a pop-up list.
Shows actions that are in progress and their expected durations. If the duration is not known, the indicator can show this as well.
There are two types of progress indicators types:
Progress indicator, bar
Progress indicator, spinner
Class: MBanner
Banner
Provides a drop-in notification to the user. A notification automatically disappears after a while. A banner created by an application is only visible in that specific application. To create a system-wide notification, use the MNotification API.
Copyright © 2010 Nokia Corporation | MeeGo Touch |