AdgTextual

AdgTextual — An interface for entities that embeds text

Synopsis

struct              AdgTextualIface;
gchar *             adg_textual_dup_text                (AdgTextual *textual);
AdgDress            adg_textual_get_font_dress          (AdgTextual *textual);
void                adg_textual_set_font_dress          (AdgTextual *textual,
                                                         AdgDress dress);
void                adg_textual_set_text                (AdgTextual *textual,
                                                         const gchar *text);
void                adg_textual_text_changed            (AdgTextual *textual,
                                                         const gchar *old_text);

Description

The AdgTextual interface should be implemented by entities that can be expressed by text. AdgToyText is a typical case but also more complex entities could implement it.

Details

struct AdgTextualIface

struct AdgTextualIface {
};

The virtual methods set_text and dup_text must be implemented by all the types which implement this interface.

Since 1.0

adg_textual_dup_text ()

gchar *             adg_textual_dup_text                (AdgTextual *textual);

Gets a duplicate of the current text bound to textual.

`textual` :	an object that implements AdgTextual
Returns :	the current text of `textual`: free with `g_free()` when finished

Since 1.0

adg_textual_get_font_dress ()

AdgDress            adg_textual_get_font_dress          (AdgTextual *textual);

Gets the current font dress of textual, eventually resolved to an AdgFontStyle before the rendering.

`textual` :	an object that implements AdgTextual
Returns :	the current font dress of `textual`. [transfer none]

Since 1.0

adg_textual_set_font_dress ()

void                adg_textual_set_font_dress          (AdgTextual *textual,
                                                         AdgDress dress);

Sets the font dress of textual to dress.

`textual` :	an object that implements AdgTextual
`dress` :	the new dress

Since 1.0

adg_textual_set_text ()

void                adg_textual_set_text                (AdgTextual *textual,
                                                         const gchar *text);

Sets a new text on textual. If text is the same as the old text no actions are performed, otherwise the set_text() virtual method is called and the "text-changed" signal is emitted.

`textual` :	an object that implements AdgTextual
`text` :	the new text to be set

Since 1.0

adg_textual_text_changed ()

void                adg_textual_text_changed            (AdgTextual *textual,
                                                         const gchar *old_text);

Emits the "text-changed" signal on textual.

Note

This function is only useful when creating a new class that implements the AdgTextual interface.

`textual` :	an object that implements AdgTextual
`old_text` :	the old text bound to `textual`

Since 1.0

			adg-1 reference manual
Top \| Description