## GdauiRtEditor

GdauiRtEditor — Rich text editor which uses a subset of the txt2tags markup.

## Synopsis

    struct              GdauiRtEditor;
    GtkWidget *         gdaui_rt_editor_new                 (void);
    gchar *             gdaui_rt_editor_get_contents        (GdauiRtEditor *editor);
    void                gdaui_rt_editor_set_contents        (GdauiRtEditor *editor,
                                                             const gchar *markup,
                                                             gint length);
    void                gdaui_rt_editor_set_editable        (GdauiRtEditor *editor,
                                                             gboolean editable);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkVBox
                                           +----GdauiRtEditor

## Implemented Interfaces

GdauiRtEditor implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Properties

      "buffer"                   GtkTextBuffer*        : Read
      "in-scrolled-window"       gboolean              : Read / Write
      "no-background"            gboolean              : Read / Write
      "show-markup"              gboolean              : Read / Write

## Signals

      "changed"                                        : Run Last

## Description

The text entered in the editor can be formatted using bold, underline, title, ... attributes and then extracted using a subset of the txt2tags markup. Use this widget to edit textual fields where some markup is desirable to organize the text.

For example the real text used to obtain the formatting in the figure is:

    blah //italic// blah.
    and ** BOLD!//both italic and bold// Bold!**
    Nice Picture: [[[R2RrUAA...y8vLy8tYQwAA]]] Yes
    - List item --One--
    - List item **Two**
     - sub1
     - sub2

where the picture's serialized data has been truncated here for readability (between the [[[ and ]]] markers). Pictures are usually inserted using the incorporated tollbar and not y hand (even though it's possible).

## Details

### struct GdauiRtEditor

    struct GdauiRtEditor;

### gdaui_rt_editor_new ()

    GtkWidget *         gdaui_rt_editor_new                 (void);

Creates a new GdauiRtEditor widget

Returns : | the new widget. [transfer full]

Since 4.2.2

### gdaui_rt_editor_get_contents ()

    gchar *             gdaui_rt_editor_get_contents        (GdauiRtEditor *editor);

Get the contents of `editor`, using the markup syntax

`editor` : | a GdauiRtEditor
Returns : | a new string, or `NULL` if there was an error. [transfer full]

Since 4.2.2

### gdaui_rt_editor_set_contents ()

    void                gdaui_rt_editor_set_contents        (GdauiRtEditor *editor,
                                                             const gchar *markup,
                                                             gint length);

Set `editor`'s contents. If `length` is -1, `markup` must be nul-terminated

`editor` : | a GdauiRtEditor
`markup` : | the text to set in `editor`, using the markup syntax (must be valid UTF-8)
`length` : | length of text in bytes.

Since 4.2.2

### gdaui_rt_editor_set_editable ()

    void                gdaui_rt_editor_set_editable        (GdauiRtEditor *editor,
                                                             gboolean editable);

Set `editor`'s editability

`editor` : | a GdauiRtEditor
`editable` : | whether it's editable

Since 4.2.2

## Property Details

### The `"buffer"` property

      "buffer"                   GtkTextBuffer*        : Read

Get access to the actual GtkTextBuffer used. Do not modify it!

### The `"in-scrolled-window"` property

      "in-scrolled-window"       gboolean              : Read / Write

Determines if the contents of the widget appears in a scrolled window or not.

Default value: TRUE

### The `"no-background"` property

      "no-background"            gboolean              : Read / Write

If set to `TRUE`, then the default text background is removed and thus the textbackground is the default widget's background.

This property has to be set before the widget is realized, and is taken into account only if the widget is not editable (when it's realized).

Default value: FALSE

### The `"show-markup"` property

      "show-markup"              gboolean              : Read / Write

Instead of showing the formatted text, display the raw text (in the txt2tags syntax)

Default value: FALSE

## Signal Details

### The `"changed"` signal

    void                user_function                      (GdauiRtEditor *gdauirteditor,
                                                            gpointer       user_data)          : Run Last

`gdauirteditor` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.