org::kde::kirigami::Units Class Reference

Inherits QtObject, QtObject, and QtObject.

Properties
real	devicePixelRatio
variant	fontMetrics
int	gridUnit
QtObject	iconSizes
int	largeSpacing
int	longDuration
int	shortDuration
int	smallSpacing

Detailed Description

Remarks

This component is a singleton

Definition at line 24 of file controls/Units.qml.

Property Documentation

real org::kde::kirigami::Units::devicePixelRatio

The ratio between physical and device-independent pixels.

This value does not depend on the \ size of the configured font. If you want to take font sizes into account when scaling elements, use theme.mSize(theme.defaultFont), units.smallSpacing and units.largeSpacing. The devicePixelRatio follows the definition of "device independent pixel" by Microsoft.

Definition at line 70 of file controls/Units.qml.

variant org::kde::kirigami::Units::fontMetrics

metrics used by the default font

Definition at line 84 of file controls/Units.qml.

int org::kde::kirigami::Units::gridUnit

The fundamental unit of space that should be used for sizes, expressed in pixels.

Given the screen has an accurate DPI settings, it corresponds to a width of the capital letter M

Definition at line 31 of file controls/Units.qml.

QtObject org::kde::kirigami::Units::iconSizes

units.iconSizes provides access to platform-dependent icon sizing

The icon sizes provided are normalized for different DPI, so icons will scale depending on the DPI.

Icon sizes from KIconLoader, adjusted to devicePixelRatio:

• small
• smallMedium
• medium
• large
• huge
• enormous

Not devicePixelRation-adjusted::

• desktop

Definition at line 49 of file controls/Units.qml.

int org::kde::kirigami::Units::largeSpacing

units.largeSpacing is the amount of spacing that should be used inside bigger UI elements, for example between an icon and the corresponding text.

Internally, this size depends on the size of the default font as rendered on the screen, so it takes user-configured font size and DPI into account.

Definition at line 63 of file controls/Units.qml.

int org::kde::kirigami::Units::longDuration

units.longDuration should be used for longer, screen-covering animations, for opening and closing of dialogs and other "not too small" animations

Definition at line 75 of file controls/Units.qml.

int org::kde::kirigami::Units::shortDuration

units.shortDuration should be used for short animations, such as accentuating a UI event, hover events, etc.

Definition at line 80 of file controls/Units.qml.

int org::kde::kirigami::Units::smallSpacing

units.smallSpacing is the amount of spacing that should be used around smaller UI elements, for example as spacing in Columns.

Internally, this size depends on the size of the default font as rendered on the screen, so it takes user-configured font size and DPI into account.

Definition at line 56 of file controls/Units.qml.

---

The documentation for this class was generated from the following file:

• controls/Units.qml