JUCE  v5.4.1-191-g0ab5e696f
JUCE API
Looking for a senior C++ dev?
I'm looking for work. Hire me!
juce::AttributedString Class Reference

A text string with a set of colour/font settings that are associated with sub-ranges of the text. More...

#include <juce_AttributedString.h>

Collaboration diagram for juce::AttributedString:

Classes

class  Attribute
 An attribute that has been applied to a range of characters in an AttributedString. More...
 

Public Types

enum  ReadingDirection {
  natural,
  leftToRight,
  rightToLeft
}
 Types of reading direction that can be used. More...
 
enum  WordWrap {
  none,
  byWord,
  byChar
}
 Types of word-wrap behaviour. More...
 

Public Member Functions

 AttributedString ()=default
 Creates an empty attributed string. More...
 
 AttributedString (const String &newString)
 Creates an attributed string with the given text. More...
 
 AttributedString (const AttributedString &)=default
 
 AttributedString (AttributedString &&) noexcept
 
void append (const String &textToAppend)
 Appends some text (with a default font and colour). More...
 
void append (const String &textToAppend, const Font &font)
 Appends some text, with a specified font, and the default colour (black). More...
 
void append (const String &textToAppend, Colour colour)
 Appends some text, with a specified colour, and the default font. More...
 
void append (const String &textToAppend, const Font &font, Colour colour)
 Appends some text, with a specified font and colour. More...
 
void append (const AttributedString &other)
 Appends another AttributedString to this one. More...
 
void clear ()
 Resets the string, clearing all text and attributes. More...
 
void draw (Graphics &g, const Rectangle< float > &area) const
 Draws this string within the given area. More...
 
const AttributegetAttribute (int index) const noexcept
 Returns one of the string's attributes. More...
 
Justification getJustification () const noexcept
 Returns the justification that should be used for laying-out the text. More...
 
float getLineSpacing () const noexcept
 Returns the extra line-spacing distance. More...
 
int getNumAttributes () const noexcept
 Returns the number of attributes that have been added to this string. More...
 
ReadingDirection getReadingDirection () const noexcept
 Returns the reading direction for the text. More...
 
const StringgetText () const noexcept
 Returns the complete text of this attributed string. More...
 
WordWrap getWordWrap () const noexcept
 Returns the word-wrapping behaviour. More...
 
AttributedStringoperator= (const AttributedString &)=default
 
AttributedStringoperator= (AttributedString &&) noexcept
 
void setColour (Range< int > range, Colour colour)
 Adds a colour attribute for the specified range. More...
 
void setColour (Colour colour)
 Removes all existing colour attributes, and applies this colour to the whole string. More...
 
void setFont (Range< int > range, const Font &font)
 Adds a font attribute for the specified range. More...
 
void setFont (const Font &font)
 Removes all existing font attributes, and applies this font to the whole string. More...
 
void setJustification (Justification newJustification) noexcept
 Sets the justification that should be used for laying-out the text. More...
 
void setLineSpacing (float newLineSpacing) noexcept
 Sets an extra line-spacing distance. More...
 
void setReadingDirection (ReadingDirection newReadingDirection) noexcept
 Sets the reading direction that should be used for the text. More...
 
void setText (const String &newText)
 Replaces all the text. More...
 
void setWordWrap (WordWrap newWordWrap) noexcept
 Sets the word-wrapping behaviour. More...
 

Private Attributes

Array< Attributeattributes
 
Justification justification = Justification::left
 
float lineSpacing = 0.0f
 
ReadingDirection readingDirection = AttributedString::natural
 
String text
 
WordWrap wordWrap = AttributedString::byWord
 

Detailed Description

A text string with a set of colour/font settings that are associated with sub-ranges of the text.

An attributed string lets you create a string with varied fonts, colours, word-wrapping, layout, etc., and draw it using AttributedString::draw().

See also
TextLayout

{Graphics}

Member Enumeration Documentation

◆ ReadingDirection

Types of reading direction that can be used.

See also
getReadingDirection, setReadingDirection
Enumerator
natural 
leftToRight 
rightToLeft 

◆ WordWrap

Types of word-wrap behaviour.

See also
getWordWrap, setWordWrap
Enumerator
none 

No word-wrapping: lines extend indefinitely.

byWord 

Lines are wrapped on a word boundary.

byChar 

Lines are wrapped on a character boundary.

Constructor & Destructor Documentation

◆ AttributedString() [1/4]

juce::AttributedString::AttributedString ( )
default

Creates an empty attributed string.

◆ AttributedString() [2/4]

juce::AttributedString::AttributedString ( const String newString)
inlineexplicit

Creates an attributed string with the given text.

◆ AttributedString() [3/4]

juce::AttributedString::AttributedString ( const AttributedString )
default

◆ AttributedString() [4/4]

juce::AttributedString::AttributedString ( AttributedString &&  )
noexcept

Member Function Documentation

◆ append() [1/5]

void juce::AttributedString::append ( const String textToAppend)

Appends some text (with a default font and colour).

◆ append() [2/5]

void juce::AttributedString::append ( const String textToAppend,
const Font font 
)

Appends some text, with a specified font, and the default colour (black).

◆ append() [3/5]

void juce::AttributedString::append ( const String textToAppend,
Colour  colour 
)

Appends some text, with a specified colour, and the default font.

◆ append() [4/5]

void juce::AttributedString::append ( const String textToAppend,
const Font font,
Colour  colour 
)

Appends some text, with a specified font and colour.

◆ append() [5/5]

void juce::AttributedString::append ( const AttributedString other)

Appends another AttributedString to this one.

Note that this will only append the text, fonts, and colours - it won't copy any other properties such as justification, line-spacing, etc from the other object.

◆ clear()

void juce::AttributedString::clear ( )

Resets the string, clearing all text and attributes.

Note that this won't affect global settings like the justification type, word-wrap mode, etc.

◆ draw()

void juce::AttributedString::draw ( Graphics g,
const Rectangle< float > &  area 
) const

Draws this string within the given area.

The layout of the string within the rectangle is controlled by the justification value passed to setJustification().

◆ getAttribute()

const Attribute& juce::AttributedString::getAttribute ( int  index) const
inlinenoexcept

Returns one of the string's attributes.

The index provided must be less than getNumAttributes(), and >= 0.

◆ getJustification()

Justification juce::AttributedString::getJustification ( ) const
inlinenoexcept

Returns the justification that should be used for laying-out the text.

This may include both vertical and horizontal flags.

◆ getLineSpacing()

float juce::AttributedString::getLineSpacing ( ) const
inlinenoexcept

Returns the extra line-spacing distance.

◆ getNumAttributes()

int juce::AttributedString::getNumAttributes ( ) const
inlinenoexcept

Returns the number of attributes that have been added to this string.

◆ getReadingDirection()

ReadingDirection juce::AttributedString::getReadingDirection ( ) const
inlinenoexcept

Returns the reading direction for the text.

◆ getText()

const String& juce::AttributedString::getText ( ) const
inlinenoexcept

Returns the complete text of this attributed string.

◆ getWordWrap()

WordWrap juce::AttributedString::getWordWrap ( ) const
inlinenoexcept

Returns the word-wrapping behaviour.

◆ operator=() [1/2]

AttributedString& juce::AttributedString::operator= ( const AttributedString )
default

◆ operator=() [2/2]

AttributedString& juce::AttributedString::operator= ( AttributedString &&  )
noexcept

◆ setColour() [1/2]

void juce::AttributedString::setColour ( Range< int range,
Colour  colour 
)

Adds a colour attribute for the specified range.

◆ setColour() [2/2]

void juce::AttributedString::setColour ( Colour  colour)

Removes all existing colour attributes, and applies this colour to the whole string.

◆ setFont() [1/2]

void juce::AttributedString::setFont ( Range< int range,
const Font font 
)

Adds a font attribute for the specified range.

◆ setFont() [2/2]

void juce::AttributedString::setFont ( const Font font)

Removes all existing font attributes, and applies this font to the whole string.

◆ setJustification()

void juce::AttributedString::setJustification ( Justification  newJustification)
noexcept

Sets the justification that should be used for laying-out the text.

This may include both vertical and horizontal flags.

◆ setLineSpacing()

void juce::AttributedString::setLineSpacing ( float  newLineSpacing)
noexcept

Sets an extra line-spacing distance.

◆ setReadingDirection()

void juce::AttributedString::setReadingDirection ( ReadingDirection  newReadingDirection)
noexcept

Sets the reading direction that should be used for the text.

◆ setText()

void juce::AttributedString::setText ( const String newText)

Replaces all the text.

This will change the text, but won't affect any of the colour or font attributes that have been added.

◆ setWordWrap()

void juce::AttributedString::setWordWrap ( WordWrap  newWordWrap)
noexcept

Sets the word-wrapping behaviour.

Member Data Documentation

◆ attributes

Array<Attribute> juce::AttributedString::attributes
private

◆ justification

Justification juce::AttributedString::justification = Justification::left
private

◆ lineSpacing

float juce::AttributedString::lineSpacing = 0.0f
private

◆ readingDirection

ReadingDirection juce::AttributedString::readingDirection = AttributedString::natural
private

◆ text

String juce::AttributedString::text
private

◆ wordWrap

WordWrap juce::AttributedString::wordWrap = AttributedString::byWord
private

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