String defines a graphical 2D text, that can be drawn on screen. More...

#include <String.hpp>

Inheritance diagram for sf::String:

Public Types
enum	Style { Regular = 0, Bold = 1 << 0, Italic = 1 << 1, Underlined = 1 << 2 }
	Enumerate the string drawing styles. More...
Public Member Functions
	String (const std::string &Text, const Font &CharFont=Font::GetDefaultFont(), float Size=30.f)
	Construct the string from a multibyte text.
	String (const std::wstring &Text=L"", const Font &CharFont=Font::GetDefaultFont(), float Size=30.f)
	Construct the string from a unicode text.
void	SetText (const std::string &Text)
	Set the text (from a multibyte string)
void	SetText (const std::wstring &Text)
	Set the text (from a unicode string)
void	SetFont (const Font &CharFont)
	Set the font of the string.
void	SetSize (float Size)
	Set the size of the string The default size is 30.
void	SetStyle (unsigned long TextStyle)
	Set the style of the text The default style is Regular.
const std::wstring &	GetUnicodeText () const
	Get the text (returns a unicode string)
std::string	GetText () const
	Get the text (returns a multibyte string)
const Font &	GetFont () const
	Get the font used by the string.
float	GetSize () const
	Get the size of the characters.
unsigned long	GetStyle () const
	Get the style of the text.
FloatRect	GetRect () const
	Get the string rectangle on screen.
void	SetPosition (float X, float Y)
	Set the position of the object (take 2 values)
void	SetPosition (const Vector2f &Position)
	Set the position of the object (take a 2D vector)
void	SetX (float X)
	Set the X position of the object.
void	SetY (float Y)
	Set the Y position of the object.
void	SetScale (float ScaleX, float ScaleY)
	Set the scale of the object (take 2 values)
void	SetScale (const Vector2f &Scale)
	Set the scale of the object (take a 2D vector)
void	SetScaleX (float FactorX)
	Set the X scale factor of the object.
void	SetScaleY (float FactorY)
	Set the Y scale factor of the object.
void	SetCenter (float CenterX, float CenterY)
	Set the center of the object, in coordinates relative to the top-left of the object (take 2 values).
void	SetCenter (const Vector2f &Center)
	Set the center of the object, in coordinates relative to the top-left of the object (take a 2D vector).
void	SetRotation (float Rotation)
	Set the orientation of the object.
void	SetColor (const Color &Col)
	Set the color of the object.
void	SetBlendMode (Blend::Mode Mode)
	Set the blending mode for the object.
const Vector2f &	GetPosition () const
	Get the position of the object.
const Vector2f &	GetScale () const
	Get the current scale of the object.
const Vector2f &	GetCenter () const
	Get the center of the object.
float	GetRotation () const
	Get the orientation of the object.
const Color &	GetColor () const
	Get the color of the object.
Blend::Mode	GetBlendMode () const
	Get the current blending mode.
void	Move (float OffsetX, float OffsetY)
	Move the object of a given offset (take 2 values)
void	Move (const Vector2f &Offset)
	Move the object of a given offset (take a 2D vector)
void	Scale (float FactorX, float FactorY)
	Scale the object (take 2 values)
void	Scale (const Vector2f &Factor)
	Scale the object (take a 2D vector)
void	Rotate (float Angle)
	Rotate the object.
Protected Member Functions
virtual void	Render (const RenderWindow &Window) const
	/see Drawable::Render
const Matrix3 &	GetMatrix () const
	Get the transform matrix of the drawable.

Detailed Description

String defines a graphical 2D text, that can be drawn on screen.

Definition at line 42 of file String.hpp.

Member Enumeration Documentation

enum sf::String::Style

Enumerate the string drawing styles.

Enumerator:

Regular	Regular characters, no style.
Bold	Characters are bold.
Italic	Characters are in italic.
Underlined	Characters are underlined.

Definition at line 49 of file String.hpp.

Constructor & Destructor Documentation

sf::String::String	(	const std::string &	Text,
		const Font &	CharFont = `Font::GetDefaultFont()`,
		float	Size = `30.f`
	)

Construct the string from a multibyte text.

Parameters:

Text	: Text assigned to the string
Font	: Font used to draw the string (SFML built-in font by default)
Size	: Characters size (30 by default)

sf::String::String	(	const std::wstring &	Text = `L""`,
		const Font &	CharFont = `Font::GetDefaultFont()`,
		float	Size = `30.f`
	)

Construct the string from a unicode text.

Parameters:

Text	: Text assigned to the string ("" by default)
Font	: Font used to draw the string (SFML built-in font by default)
Size	: Characters size (30 by default)

Member Function Documentation

Blend::Mode sf::Drawable::GetBlendMode ( ) const [inherited]

Get the current blending mode.

Returns:: Current blending mode

const Vector2f& sf::Drawable::GetCenter ( ) const [inherited]

Get the center of the object.

Returns:: Current position of the center

const Color& sf::Drawable::GetColor ( ) const [inherited]

Get the color of the object.

Returns:: Current color

const Font& sf::String::GetFont ( ) const

Get the font used by the string.

Returns:: Font used

const Matrix3& sf::Drawable::GetMatrix ( ) const [protected, inherited]

Get the transform matrix of the drawable.

Returns:: Transform matrix

const Vector2f& sf::Drawable::GetPosition ( ) const [inherited]

Get the position of the object.

Returns:: Current position

FloatRect sf::String::GetRect ( ) const

Get the string rectangle on screen.

Returns:: Rectangle contaning the string in screen coordinates

float sf::Drawable::GetRotation ( ) const [inherited]

Get the orientation of the object.

Rotation is always in the range [0, 360]

Returns:: Current rotation, in degrees

const Vector2f& sf::Drawable::GetScale ( ) const [inherited]

Get the current scale of the object.

Returns:: Current scale factor (always positive)

float sf::String::GetSize ( ) const

Get the size of the characters.

Returns:: Size of the characters

unsigned long sf::String::GetStyle ( ) const

Get the style of the text.

Returns:: Current string style (combination of Style enum values)

std::string sf::String::GetText ( ) const

Get the text (returns a multibyte string)

Returns:: Text

const std::wstring& sf::String::GetUnicodeText ( ) const

Get the text (returns a unicode string)

Returns:: Text

void sf::Drawable::Move	(	float	OffsetX,
		float	OffsetY
	)		`[inherited]`

Move the object of a given offset (take 2 values)

Parameters:

OffsetX	: X offset
OffsetY	: Y offset

void sf::Drawable::Move ( const Vector2f & Offset ) [inherited]

Move the object of a given offset (take a 2D vector)

Parameters:

Offset : Amount of units to move the object of

virtual void sf::String::Render ( const RenderWindow & Window ) const [protected, virtual]

/see Drawable::Render

Implements sf::Drawable.

void sf::Drawable::Rotate ( float Angle ) [inherited]

Rotate the object.

Parameters:

Angle : Angle of rotation, in degrees

void sf::Drawable::Scale	(	float	FactorX,
		float	FactorY
	)		`[inherited]`

Scale the object (take 2 values)

Parameters:

FactorX	: Scaling factor on X (must be strictly positive)
FactorY	: Scaling factor on Y (must be strictly positive)

void sf::Drawable::Scale ( const Vector2f & Factor ) [inherited]

Scale the object (take a 2D vector)

Parameters:

Factor : Scaling factors (both values must be strictly positive)

void sf::Drawable::SetBlendMode ( Blend::Mode Mode ) [inherited]

Set the blending mode for the object.

The default blend mode is Blend::Alpha

Parameters:

Mode	: New blending mode

void sf::Drawable::SetCenter	(	float	CenterX,
		float	CenterY
	)		`[inherited]`

Set the center of the object, in coordinates relative to the top-left of the object (take 2 values).

The default center is (0, 0)

Parameters:

CenterX	: X coordinate of the center
CenterY	: Y coordinate of the center

void sf::Drawable::SetCenter ( const Vector2f & Center ) [inherited]

Set the center of the object, in coordinates relative to the top-left of the object (take a 2D vector).

The default center is (0, 0)

Parameters:

Center : New center

void sf::Drawable::SetColor ( const Color & Col ) [inherited]

Set the color of the object.

The default color is white

Parameters:

Col	: New color

void sf::String::SetFont ( const Font & CharFont )

Set the font of the string.

Parameters:

Font	: Font to use

void sf::Drawable::SetPosition ( const Vector2f & Position ) [inherited]

Set the position of the object (take a 2D vector)

Parameters:

Position : New position

void sf::Drawable::SetPosition	(	float	X,
		float	Y
	)		`[inherited]`

Set the position of the object (take 2 values)

Parameters:

X	: New X coordinate
Y	: New Y coordinate

void sf::Drawable::SetRotation ( float Rotation ) [inherited]

Set the orientation of the object.

Parameters:

Rotation : Angle of rotation, in degrees

void sf::Drawable::SetScale	(	float	ScaleX,
		float	ScaleY
	)		`[inherited]`

Set the scale of the object (take 2 values)

Parameters:

ScaleX	: New horizontal scale (must be strictly positive)
ScaleY	: New vertical scale (must be strictly positive)

void sf::Drawable::SetScale ( const Vector2f & Scale ) [inherited]

Set the scale of the object (take a 2D vector)

Parameters:

Scale : New scale (both values must be strictly positive)

void sf::Drawable::SetScaleX ( float FactorX ) [inherited]

Set the X scale factor of the object.

Parameters:

X	: New X scale factor

void sf::Drawable::SetScaleY ( float FactorY ) [inherited]

Set the Y scale factor of the object.

Parameters:

Y	: New Y scale factor

void sf::String::SetSize ( float Size )

Set the size of the string The default size is 30.

Parameters:

Size	: New size, in pixels

void sf::String::SetStyle ( unsigned long TextStyle )

Set the style of the text The default style is Regular.

Parameters:

TextStyle : New text style, (combination of Style enum values)

void sf::String::SetText ( const std::string & Text )

Set the text (from a multibyte string)

Parameters:

Text	: New text

void sf::String::SetText ( const std::wstring & Text )

Set the text (from a unicode string)

Parameters:

Text	: New text

void sf::Drawable::SetX ( float X ) [inherited]

Set the X position of the object.

Parameters:

X	: New X coordinate

void sf::Drawable::SetY ( float Y ) [inherited]

Set the Y position of the object.

Parameters:

Y	: New Y coordinate

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

String.hpp

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation