API reference - Class DText

Notation used in Ruby API documentation

Description: A text object

A text object has a point (location), a text, a text transformation, a text size and a font id. Text size and font id are provided to be be able to render the text correctly. Text objects are used as labels (i.e. for pins) or to indiciate a particular position.

The DText class uses floating-point coordinates. A class that operates with integer coordinates is Text.

See The Database API for more details about the database objects.

Public constructors

new DTextnewDefault constructor
new DTextnew(string string,
const DTrans trans)
Constructor with string and transformation
new DTextnew(string string,
double x,
double y)
Constructor with string and location
new DTextnew(string string,
const DTrans trans,
double height,
int font)
Constructor with string, transformation, text height and font

Public methods

[const]bool!=(const DText text)Inequality
[const]bool<(const DText t)Less operator
[const]bool==(const DText text)Equality
[const]voidassign(const DText other)Assign the contents of another object to self
voidcreateEnsures the C++ object is created
voiddestroyExplicitly destroy the object
[const]booldestroyed?Returns a value indicating whether the object was already destroyed
[const]DTextdupCreates a copy of self
intfontGet the font number
voidfont=(int f)Set the font number
inthalignGet the horizontal alignment
voidhalign=(int a)Set the horizontal alignment
[const]boolis_const_object?Returns a value indicating whether the reference is a const reference
DTextmove(const DPoint distance)Moves the text by a certain distance (modifies self)
DTextmove(double dx,
double dy)
Moves the text by a certain distance (modifies self)
DTextmoved(const DPoint distance)Returns the text moved by a certain distance (does not modify self)
DTextmoved(double dx,
double dy)
Returns the text moved by a certain distance (does not modify self)
[const]doublesizeGet the text height
voidsize=(double s)Set the text height of this object
[const]stringstringGet the text string
voidstring=(string text)Assign a text string to this object
[const]stringto_sConvert to a string
[const]DTranstransGet the transformation
voidtrans=(const DTrans t)Assign a transformation (text position and orientation) to this object
[const]DTexttransformed(const DTrans t)Transform the text with the given simple transformation
[const]DTexttransformed(const DCplxTrans t)Transform the text with the given complex transformation
intvalignGet the vertical alignment
voidvalign=(int a)Set the vertical alignment
[const]doublexGets the x location of the text
voidx=(double x)Sets the x location of the text
[const]doubleyGets the y location of the text
voidy=(double y)Sets the y location of the text

Public static methods and constants

DTextfrom_itext(const Text double_text)Construct an floating-point coordinate text object from an integer coordinate text
new DTextfrom_s(string s)Creates an object from a string

Deprecated methods (protected, public, static, non-static and constructors)

[static]new DTextnew_st(string string,
const DTrans trans)
Use of this method is deprecated. Use new instead
[static]new DTextnew_sthf(string string,
const DTrans trans,
double height,
int font)
Use of this method is deprecated. Use new instead
[static]new DTextnew_sxy(string string,
double x,
double y)
Use of this method is deprecated. Use new instead
[const]DTexttransformed_cplx(const DCplxTrans t)Use of this method is deprecated. Use transformed instead

Detailed description

[const] bool !=(const DText text)

Description: Inequality

Return true, if this text object and the given text are not equal

[const] bool <(const DText t)

Description: Less operator

t:The object to compare against

This operator is provided to establish some, not necessarily a certain sorting order

[const] bool ==(const DText text)

Description: Equality

Return true, if this text object and the given text are equal

[const] void assign(const DText other)

Description: Assign the contents of another object to self

This method assigns the contents of another object to self. This is a deep copy that does not only copy the reference but the actual content.

void create

Description: Ensures the C++ object is created

Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created.

void destroy

Description: Explicitly destroy the object

Explicitly destroy the object on C++ side if it was owned by the Ruby interpreter. Subsequent access to this object will throw an exception. If the object is not owned by Ruby, this method will do nothing.

[const] bool destroyed?

Description: Returns a value indicating whether the object was already destroyed

This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself.

[const] DText dup

Description: Creates a copy of self

int font

Description: Get the font number

void font=(int f)

Description: Set the font number

[static] DText from_itext(const Text double_text)

Description: Construct an floating-point coordinate text object from an integer coordinate text

[static] new DText from_s(string s)

Description: Creates an object from a string

Creates the object from a string representation (as returned by to_s)

This method has been added in version 0.23.

int halign

Description: Get the horizontal alignment

See halign= for a description of this property.

void halign=(int a)

Description: Set the horizontal alignment

This property specifies how the text is aligned relative to the anchor point. Allowed values for this property are 0 (left), 1 (center) and 2 (right). This property has been introduced in version 0.22.

[const] bool is_const_object?

Description: Returns a value indicating whether the reference is a const reference

This method returns true, if self is a const reference. In that case, only const methods may be called on self.

DText move(const DPoint distance)

Description: Moves the text by a certain distance (modifies self)

p:The offset to move the text.
Returns:A reference to this text object

Moves the text by a given offset and returns the moved text. Does not check for coordinate overflows.

DText move(double dx,double dy)

Description: Moves the text by a certain distance (modifies self)

dx:The x distance to move the text.
dy:The y distance to move the text.
Returns:A reference to this text object

Moves the text by a given distance in x and y direction and returns the moved text. Does not check for coordinate overflows.

This method was introduced in version 0.23.

DText moved(const DPoint distance)

Description: Returns the text moved by a certain distance (does not modify self)

p:The offset to move the text.
Returns:The moved text.

Moves the text by a given offset and returns the moved text. Does not modify *this. Does not check for coordinate overflows.

DText moved(double dx,double dy)

Description: Returns the text moved by a certain distance (does not modify self)

dx:The x distance to move the text.
dy:The y distance to move the text.
Returns:The moved text.

Moves the text by a given offset and returns the moved text. Does not modify *this. Does not check for coordinate overflows.

This method was introduced in version 0.23.

[static] new DText new

Description: Default constructor

Creates a text with unit transformation and empty text.

[static] new DText new(string string,const DTrans trans)

Description: Constructor with string and transformation

A string and a transformation is provided to this constructor. The transformation specifies the location and orientation of the text object.

[static] new DText new(string string,double x,double y)

Description: Constructor with string and location

A string and a location is provided to this constructor. The location is specifies as a pair of x and y coordinates.

This method has been introduced in version 0.23.

[static] new DText new(string string,const DTrans trans,double height,int font)

Description: Constructor with string, transformation, text height and font

A string and a transformation is provided to this constructor. The transformation specifies the location and orientation of the text object. In addition, the text height and font can be specified.

[static] new DText new_st(string string,const DTrans trans)

Description: Constructor with string and transformation

This method is deprecated. Use method 'new' instead

[static] new DText new_sthf(string string,const DTrans trans,double height,int font)

Description: Constructor with string, transformation, text height and font

This method is deprecated. Use method 'new' instead

[static] new DText new_sxy(string string,double x,double y)

Description: Constructor with string and location

This method is deprecated. Use method 'new' instead

[const] double size

Description: Get the text height

void size=(double s)

Description: Set the text height of this object

[const] string string

Description: Get the text string

void string=(string text)

Description: Assign a text string to this object

[const] string to_s

Description: Convert to a string

[const] DTrans trans

Description: Get the transformation

void trans=(const DTrans t)

Description: Assign a transformation (text position and orientation) to this object

[const] DText transformed(const DTrans t)

Description: Transform the text with the given simple transformation

t:The transformation to apply
Returns:The transformed text

[const] DText transformed(const DCplxTrans t)

Description: Transform the text with the given complex transformation

t:The magnifying transformation to apply
Returns:The transformed text (a DText now)

[const] DText transformed_cplx(const DCplxTrans t)

Description: Transform the text with the given complex transformation

t:The magnifying transformation to apply
Returns:The transformed text (a DText now)

This method is deprecated. Use method 'transformed' instead

int valign

Description: Get the vertical alignment

See valign= for a description of this property.

void valign=(int a)

Description: Set the vertical alignment

This property specifies how the text is aligned relative to the anchor point. Allowed values for this property are 0 (top), 1 (center) and 2 (bottom). This property has been introduced in version 0.22.

[const] double x

Description: Gets the x location of the text

This method has been introduced in version 0.23.

void x=(double x)

Description: Sets the x location of the text

This method has been introduced in version 0.23.

[const] double y

Description: Gets the y location of the text

This method has been introduced in version 0.23.

void y=(double y)

Description: Sets the y location of the text

This method has been introduced in version 0.23.