aurore::Label

An empty label in the default font, size and colour.

Called by frame() to draw the view onscreen. Views should not draw outside of their bounds (they may be clipped if they do so).

Overrides aurore::View::draw

Called when a layout pass ends on that view.

Overrides aurore::View::onLayout

Fired when focus is gained.

Overrides aurore::View::onFocusGained

Fired when focus is lost.

Overrides aurore::View::onFocusLost

Fired when focus is gained on this view's parent, or the parent of the parent...

Overrides aurore::View::onParentFocusGained

Fired when focus is lost on one of this view's parents. Works similarly to onParentFocusGained().

Overrides aurore::View::onParentFocusLost

Sets the text of the label.

Sets the alignment of the text inside the view. Will not move the view, only the text inside.

Default is CENTER.

Sets the alignment of the text inside the view. Will not move the view, only the text inside.

Only applies to single-line labels.

Default is CENTER.

The font size asked, in layout units (drawn times the font scale).

false: this label keeps its size whatever the font scale.

This label drawn at most max times its size, whatever the scale (with a scale of 1, as asked: nothing changes).

A single line its box is too narrow for, at a scale above 1: drawn smaller until it fits, never below the size asked (then cut as before), rather than wrapped. Nothing changes at a scale of 1.

See setShrinkToFit().

With shrinkToFit: drawn as small as size, under the size asked and at any scale, before being cut (0, the default: the size asked).

The size it is drawn at, and the same before any shrinking to fit (what the text is measured at).

nanovg's quality for the glyphs (1 by default).

The height of a line, as a multiple of the font size.

The text's colour (setThemeColor follows a theme key instead).

The font this label is drawn with (the app's default one unless set): by its id, or by the name it was loaded under (Application::loadFont*). A name not loaded leaves the font as it was. XML: fontFamily="name".

The font id the label draws with.

The font size asked, before the font scale.

The whole text, as set (not cut to fit).

The style properties the states and transitions work on, by name: backgroundColor, borderColor, lineColor (colours), borderThickness, cornerRadius, alpha, scale (numbers); a Label adds textColor, a Rectangle color, a Button textColor. Only properties that are drawn, never laid out. A subclass adds its own by overriding both and calling the base for the others.

Overrides aurore::View::getStyleProperty

Overrides aurore::View::setStyleProperty

Sets the view's text, for bind="text: …"; false when it has none.

Overrides aurore::View::setBoundText

Called on every view of the screens when the text scale changes (Application::setTextScale): a view that measures text marks itself dirty here.

Overrides aurore::View::onTextScaleChanged

Its own Observable: the label shows its value, now and at each change, as long as it lives.

The text as laid out does not fit: it is drawn cut, with an ellipsis.

Set by the measure function: the width the text needs on one line.

Set by the measure function: the width of the ellipsis.

If an "animated" label is too large to fit its bounds, the full text will be displayed in a scrolling animation instead of being truncated with an ellipsis ("...").

Unless the autoAnimate flag is set to false, a label will automatically be set to "animated" if it is focused or if one of its parent is.

Controls whether focus changes automatically animates the label or not. Doesn't stop the ongoing animation should there be one.

A single-line label will not wrap and increase its height, even if the remaining vertical space allows it.

Instead, it will always be truncated (if too large) to fit the horizontal space.

See setSingleLine().

Internal flag set by the measure function.

Draws a blinking edit cursor before the byte cursor (CursorPosition::END: at the end; UNSET: none).

Every label drawn scale times its size (1 by default), but those that keep theirs (setFontScaled(false)). It can change at any time: the labels then need laying out again (their nodes marked dirty). getFontSize() gives the size asked. Application::setTextScale does both.

See setFontScale().

Makes a label for XML (<aurore:Label>).

Simplified Chinese to Traditional Chinese

STConverter() applied to Traditional Chinese text.

The font scale (setFontScale())

The view's own role and label when the app gave none.

Overrides aurore::View::getDefaultAccessibilityRole

Overrides aurore::View::getDefaultAccessibilityLabel

the text's width as drawn

setShrinkToFitMin

from onLayout, when shrinkToFit

the text's width at that scale

should it animate?

currently animating?