Property Documentation

buttonWidthExtraSmall : const qreal

Extra small button size. Three extra small buttons fit across a portrait screen.

Access functions:

buttonWidthLarge : const qreal

Large button size. Generally only one large button will fit across a portrait screen.

Access functions:

buttonWidthMedium : const qreal

Medium button size.

Access functions:

buttonWidthSmall : const qreal

(default) small button size. Two small buttons will fit across a portrait screen.

Access functions:

buttonWidthTiny : const qreal

Default icon button width.

Access functions:

colorScheme : const ColorScheme

Defined by the currently active Sailfish ambience. In the DarkOnLight color scheme the platform text and icons are painted in dark color on light background compared to the LightOnDark scheme with normal light content on top of the dark background.

Apps that use platform colors and icons don't need to worry about the color scheme, the explicit property is exposed so that any custom UI elements defined by the app can adapt to the underlying theme changes.

• Theme.LightOnDark - original ambience style with dark wallpaper and light app content
• Theme.DarkOnLight - light wallpaper and dark app content

Access functions:

Notifier signal:

coverSizeLarge : const QSize

Large application cover size

Access functions:

coverSizeSmall : const QSize

Small application cover size

Access functions:

darkPrimaryColor : const QColor

Primary color over always light content. See also colors on top of custom content.

Access functions:

darkSecondaryColor : const QColor

Secondary color over always light content. See also colors on top of custom content.

Access functions:

errorColor : const QColor

Used to indicate errors in components.

Access functions:

Notifier signal:

flickDeceleration : const qreal

Flick deceleration of Sailfish-style flickables.

You don't need to access this directly if your application uses Silica's own flickable types — that is, SilicaFlickable, SilicaListView, and SilicaGridView.

Access functions:

fontFamily : const QString

The default font family.

Access functions:

Notifier signal:

fontFamilyHeading : const QString

Font family used to display heading text

Access functions:

Notifier signal:

fontSizeExtraLarge : const int

For large heading text, such as those of PageHeader and ViewPlaceholder.

Access functions:

Notifier signal:

fontSizeExtraLargeBase : const int

Same as standard font size without "Base", but unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

Access functions:

fontSizeExtraSmall : const int

For smaller secondary text, such as the description text in TextSwitch and ValueButton.

Access functions:

Notifier signal:

fontSizeExtraSmallBase : const int

Same as standard font size without "Base", but unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

Access functions:

fontSizeHuge : const int

For very large headings or UI components where the text dominates, such as in a keypad button.

Access functions:

Notifier signal:

fontSizeHugeBase : const int

Same as standard font size without "Base", but unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

Access functions:

fontSizeLarge : const int

For large heading text, such as those of PageHeader and ViewPlaceholder.

Access functions:

Notifier signal:

fontSizeLargeBase : const int

Same as standard font size without "Base", but unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

Access functions:

fontSizeMedium : const int

The most common text size; this is the default font size of Label and most UI controls.

Access functions:

Notifier signal:

fontSizeMediumBase : const int

Same as standard font size without "Base", but unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

Access functions:

fontSizeSmall : const int

For general secondary text or paragraphs of non-interactive text.

Access functions:

Notifier signal:

fontSizeSmallBase : const int

Same as standard font size without "Base", but unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

Access functions:

fontSizeTiny : const int

The smallest recommended font size; for use where space is severely restricted

Access functions:

Notifier signal:

fontSizeTinyBase : const int

Same as standard font size without "Base", but unaffected by user font size setting changes. Avoid using the base values if you can, in general they are only appropriate in rare cases where the space reserved for the label is seriously restricted and preferred strategies like wrapping would produce sub-optimal results.

Access functions:

highlightBackgroundColor : const QColor

This and highlightBackgroundOpacity properties hold standard colors for rendering a highlighted background according to the current Sailfish ambience.

Access functions:

Notifier signal:

highlightBackgroundOpacity : const float

Used to apply an appropriate opacity when painting the highlightBackgroundColor.

Access functions:

See also Theme::highlightBackgroundColor.

highlightColor : const QColor

Main color for non-interactive text and press highlights. See also coloring interactive content.

Access functions:

Notifier signal:

highlightDimmerColor : const QColor

Used to paint the highlight color with a darker shade (for example, when dimming a region to bring attention to other areas of the UI). See also coloring interactive content.

Access functions:

Notifier signal:

horizontalPageMargin : const qreal

Used between the page content and the left and right side of the display. This value is typically Theme.paddingLarge on smaller displays, e.g. phones, and can be wider on larger displays, e.g. tablets.

Margins on the left and right sides of the display should be set to Theme.horizontalPageMargin.

Access functions:

iconSizeExtraLarge : const qreal

Suits very large icon displays. See also icon usage.

Access functions:

iconSizeExtraSmall : const qreal

Suits smallest icons, such as those in the Home status area. See also icon usage.

Access functions:

iconSizeLarge : const qreal

Suits larger icon displays and buttons. See also icon usage.

Access functions:

iconSizeLauncher : const qreal

For icons in the Home app grid. See also icon usage.

Access functions:

iconSizeMedium : const qreal

The most common icon size; suits icons in small to medium-sized list items. See also icon usage.

Access functions:

iconSizeSmall : const qreal

Suits small icons, such as CoverAction icons and icons on the Events screen. See also icon usage.

Access functions:

iconSizeSmallPlus : const qreal

A larger variant of iconSizeSmall, used for notification icons. See also icon usage.

Access functions:

itemSizeExtraLarge : const qreal

Suits larger items such as list delegates with an image thumbnail and associated image details

Access functions:

itemSizeExtraSmall : const qreal

Suits the smallest UI controls; used as the height of buttons and pulley menu entries

Access functions:

itemSizeHuge : const qreal

Suits larger items such as images in a fullscreen grid of thumbnail images

Access functions:

itemSizeLarge : const qreal

Suits controls with several lines of text or more prominent text; this is the height of a page header in portrait orientation

Access functions:

itemSizeMedium : const qreal

Suits average-sized UI controls; used as the height of list items with two lines of text

Access functions:

itemSizeSmall : const qreal

Suits small UI controls; used as the height of list items with one line of text

Access functions:

lightPrimaryColor : const QColor

Primary color over always dark content. See also colors on top of custom content.

Access functions:

lightSecondaryColor : const QColor

Secondary color over always dark content. See also colors on top of custom content.

Access functions:

maximumFlickVelocity : const qreal

Maximum flick velocity of Sailfish-style flickables.

You don't need to access this directly if your application uses Silica's own flickable types — that is, SilicaFlickable, SilicaListView, and SilicaGridView.

Access functions:

opacityFaint : const qreal

Opacity used to render unavailable content, e.g. requiring installation. See also opacity usage.

Access functions:

opacityHigh : const qreal

Opacity used to render de-emphasized content. See also opacity usage.

Access functions:

opacityLow : const qreal

Opacity used to render disabled content. See also opacity usage.

Access functions:

opacityOverlay : const qreal

Opacity used to render overlay content. See also opacity usage.

Access functions:

overlayBackgroundColor : const QColor

Background color of system dialogs opened on top of the application.

Access functions:

Notifier signal:

paddingLarge : const qreal

Commonly used to divide UI components, particularly as the vertical spacing between components in a Column

Access functions:

paddingMedium : const qreal

Commonly used to separate related UI components without visually disassocating them

Access functions:

paddingSmall : const qreal

commonly used to separate UI components by a slight margin, particularly in space-restricted areas

Access functions:

pixelRatio : const qreal

Can be used to scale custom layout parameters to the target resolution. In most cases custom layout parameters should be avoided; instead, base your application layouts on the platform size and padding parameters exposed through the Theme object.

Access functions:

primaryColor : const QColor

Adds emphasis to active areas of the UI. See also coloring interactive content.

Access functions:

Notifier signal:

secondaryColor : const QColor

Used to paint less prominent parts of the UI. See also coloring interactive content.

Access functions:

Notifier signal:

secondaryHighlightColor : const QColor

Used to paint less prominent parts of the UI in a highlighted manner. See also coloring interactive content.

Access functions:

Notifier signal:

startDragDistance : const int

This property holds the distance a touch must move before the action will be considered a move.

Access functions: