TextStyle

#include <bb/cascades/TextStyle>

Represents a text style that defines how a text is rendered.

Each text style has a different set of visual characteristics associated with it like weight, font style etc. If set to other values than their default values, these values will override the default characteristic of controls that they are applied on. For example setting fontFamily to "helvetica" on a textstyle applied to a label will override the default system font with a font from the Helvetica family.

Since:

BlackBerry 10.0.0

Inheritance

bb::cascades::Resource
	bb::cascades::TextStyle

Public Functions Index

	TextStyle ()
virtual	~TextStyle ()
	TextStyle (const TextStyle &other)
TextStyle &	operator= (const TextStyle &other)
void	setFontFamily (const QString &fontFamily)
QString	fontFamily () const
void	resetFontFamily ()
void	setFontStyle (FontStyle::Type fontStyle)
FontStyle::Type	fontStyle () const
void	resetFontStyle ()
void	setFontWeight (bb::cascades::FontWeight::Type fontWeight)
bb::cascades::FontWeight::Type	fontWeight () const
void	resetFontWeight ()
void	setColor (const bb::cascades::ColorPaint &color)
void	setColor (const QVariant &color)
QVariant	color () const
void	resetColor ()
void	setLineHeight (float lineHeight)
float	lineHeight () const
void	resetLineHeight ()
void	setFontSizeValue (float size)
float	fontSizeValue () const
void	resetFontSizeValue ()
void	setFontSize (FontSize::Type size)
FontSize::Type	fontSize () const
void	resetFontSize ()
void	setTextAlign (bb::cascades::TextAlign::Type alignment)
bb::cascades::TextAlign::Type	textAlign () const
void	resetTextAlign ()
bool	isNull () const

Public Functions

TextStyle ()

Constructs a null TextStyle.

Since:

BlackBerry 10.0.0

virtual~TextStyle ()

Destructor.

TextStyle (
const TextStyle &other)

Constructs a copy of another TextStyle.

TextStyle a = SystemDefaults::TextStyles::bigText();
TextStyle b(a);

Parameters
other	The TextStyle to be copied.

Since:

BlackBerry 10.0.0

TextStyle & operator= (
const TextStyle &other)

Assigns another TextStyle to this TextStyle.

Parameters
other	The TextStyle to be assigned.

Return:

A reference to the TextStyle.

Since:

BlackBerry 10.0.0

void setFontFamily (
const QString &fontFamily)

Sets the font family name to use for font matching in the TextStyle.

For example setting font family to "helvetica" will make the TextStyle try to find a font of the helvetica family. The font family name can be specified with multiple fallbacks specified as either ordinary font familys (times, arial etc.) or generic family names (serif, sans-serif) The names should be separated by a comma and family names containing multiple word like Times New Roman should be enclosed by quotations. Start by specifying specific font families and end with generic font families. Currently only one specific font family is supported.

Example:

style.setFontFamily("\"Times New Roman\", serif");

Parameters
fontFamily	The font family name.

Since:

BlackBerry 10.0.0

QString fontFamily ()

Returns the font family for the TextStyle.

Return:

The font family if set, otherwise QString::null is returned.

Since:

BlackBerry 10.0.0

void resetFontFamily ()

Resets the font family to its default.

The default value is a QString::null.

Since:

BlackBerry 10.0.0

void setFontStyle (
FontStyle::TypefontStyle)

Sets the font style.

Parameters
fontStyle	The style to use.

Since:

BlackBerry 10.0.0

FontStyle::Type fontStyle ()

Returns the font style.

Return:

The font style if set, otherwise FontStyle::Default is returned.

Since:

BlackBerry 10.0.0

void resetFontStyle ()

Resets the font style to its default value.

Since:

BlackBerry 10.0.0

void setFontWeight (
bb::cascades::FontWeight::TypefontWeight)

Set the font weight.

Parameters
fontWeight	The weight to use.

Since:

BlackBerry 10.0.0

bb::cascades::FontWeight::Type fontWeight ()

Returns the font weight.

Return:

The weight if set, otherwise FontWeight::Default is returned.

Since:

BlackBerry 10.0.0

void resetFontWeight ()

Resets the font weight to its default value.

Since:

BlackBerry 10.0.0

void setColor (
const bb::cascades::ColorPaint &color)

Sets the text color.

Setting an invalid color is equivalent to calling resetColor().

Parameters
color	The color to use.

Since:

BlackBerry 10.0.0

void setColor (
const QVariant &color)

Convenience method for setting the text color for colors wrapped in QVariant.

Passed QVariant can either be invalid or contain values of type Color or PaintColor or it will be ignored.

Setting an invalid QVariant or a QVariant containing invalid color is equivalent to calling resetColor().

Example:

style2.setColor(style1.color());

Parameters
color	A QVariant containing the color to use or an invalid QVariant

Since:

BlackBerry 10.0.0

QVariant color ()

Returns the text color.

Returned QVariant will be either invalid or contain values of type Color or ColorPaint. Invalid QVariant signifies an unset color.

Use QVariant::canConvert<Type T>() to find actual type, and then QVariant::value<Type T>() to get the value.

For example:

QVariant v = style->textColor();
if (v.canConvert<Color>()) {
  Color c = v.value<Color>();
} else if (v.canConvert<ColorPaint>()) {
  ColorPaint cp = v.value<ColorPaint>();
}

Return:

The current font color, wrapped in a QVariant or invalid QVariant if text color wasn't set

Since:

BlackBerry 10.0.0

void resetColor ()

Resets the color to its default value as an invalid Color.

Since:

BlackBerry 10.0.0

void setLineHeight (
floatlineHeight)

Sets the line height.

Distance between rows of text. 1.0 is equal to 1 ordinary row height. 1.5 would make the distance between rows 1.5 ordinary row heights. The default value is -1.0.

Parameters
lineHeight	The line height to use.

Since:

BlackBerry 10.0.0

float lineHeight ()

Returns the line height.

The default value is -1.0.

Return:

Line height if set. If not set the default value will be returned.

Since:

BlackBerry 10.0.0

void resetLineHeight ()

Resets the line height to its default value of -1.0.

Since:

BlackBerry 10.0.0

void setFontSizeValue (
floatsize)

Sets the font size value.

Font size in post script units or percent, depending on the FontSize setting. Valid ranges are >= 0. Sizes < 0 will be clamped to 0 The default value is 0.0.

If FontSize is set to PercentageValue, size value 100.0 corresponds to the size of the parent style element. If there is no parent element, the size will be in relation to the system default size, which typically matches the logical size Medium. Note, this value will take effect only when font size is set to FontSize::PointValue or FontSize::PercentageValue

Parameters
size	The font size value to use.

Since:

BlackBerry 10.0.0

float fontSizeValue ()

Returns the font size value in points or percent The unit of the return value depends on the current setting of the fontSize property.

If it is set to FontSize::PointValue, the unit is post script points. If it is set to FontSize::PercentageValue, the unit is percent and the size is relative to the point size of parent style element. If there is no parent element, the size will be in relation to the system default size, which typically matches the logical size Medium.

Return:

Font size value.

Since:

BlackBerry 10.0.0

void resetFontSizeValue ()

Resets the font size value to its default value 0.0.

Since:

BlackBerry 10.0.0

void setFontSize (
FontSize::Typesize)

Sets the logical font size.

Logical font size will be translated to actual font size according to font size set in accessibility settings.

Parameters
size	The font size to use.

Since:

BlackBerry 10.0.0

FontSize::Type fontSize ()

Returns the logical font size.

Return:

Font size.

Since:

BlackBerry 10.0.0

void resetFontSize ()

Resets the logical font size to its default value.

Since:

BlackBerry 10.0.0

void setTextAlign (
bb::cascades::TextAlign::Typealignment)

Sets the horizontal alignment for the text.

Parameters
alignment	The horizontal text alignment to use.

Since:

BlackBerry 10.0.0

bb::cascades::TextAlign::Type textAlign ()

Returns the horizontal alignment for the text.

Return:

The text alignment if set, otherwise TextAlign::Default is returned.

Since:

BlackBerry 10.0.0

void resetTextAlign ()

Resets the horizontal alignment to its default value.

Since:

BlackBerry 10.0.0

bool isNull ()

Returns true if the resource is null.

Return:

true if this resource is null, false otherwise.

Since:

BlackBerry 10.0.0

TextStyle

Inheritance

Public Functions Index

Public Functions

TextStyle ()

virtual~TextStyle ()

TextStyle (const TextStyle &other)

TextStyle & operator= (const TextStyle &other)

void setFontFamily (const QString &fontFamily)

QString fontFamily ()

void resetFontFamily ()

void setFontStyle (FontStyle::TypefontStyle)

FontStyle::Type fontStyle ()

void resetFontStyle ()

void setFontWeight (bb::cascades::FontWeight::TypefontWeight)

bb::cascades::FontWeight::Type fontWeight ()

void resetFontWeight ()

void setColor (const bb::cascades::ColorPaint &color)

void setColor (const QVariant &color)

QVariant color ()

void resetColor ()

void setLineHeight (floatlineHeight)

float lineHeight ()

void resetLineHeight ()

void setFontSizeValue (floatsize)

float fontSizeValue ()

void resetFontSizeValue ()

void setFontSize (FontSize::Typesize)

FontSize::Type fontSize ()

void resetFontSize ()

void setTextAlign (bb::cascades::TextAlign::Typealignment)

bb::cascades::TextAlign::Type textAlign ()

void resetTextAlign ()

bool isNull ()

TextStyle (
const TextStyle &other)

TextStyle & operator= (
const TextStyle &other)

void setFontFamily (
const QString &fontFamily)

void setFontStyle (
FontStyle::TypefontStyle)

void setFontWeight (
bb::cascades::FontWeight::TypefontWeight)

void setColor (
const bb::cascades::ColorPaint &color)

void setColor (
const QVariant &color)

void setLineHeight (
floatlineHeight)

void setFontSizeValue (
floatsize)

void setFontSize (
FontSize::Typesize)

void setTextAlign (
bb::cascades::TextAlign::Typealignment)