AtkEditableText

## AtkEditableText AtkEditableText — The ATK interface implemented by components containing user-editable text content. |

## Synopsis

                        AtkEditableText;
    gboolean            atk_editable_text_set_run_attributes
                                                            (AtkEditableText *text,
                                                             AtkAttributeSet *attrib_set,
                                                             gint start_offset,
                                                             gint end_offset);
    void                atk_editable_text_set_text_contents (AtkEditableText *text,
                                                             const gchar *string);
    void                atk_editable_text_insert_text       (AtkEditableText *text,
                                                             const gchar *string,
                                                             gint length,
                                                             gint *position);
    void                atk_editable_text_copy_text         (AtkEditableText *text,
                                                             gint start_pos,
                                                             gint end_pos);
    void                atk_editable_text_cut_text          (AtkEditableText *text,
                                                             gint start_pos,
                                                             gint end_pos);
    void                atk_editable_text_delete_text       (AtkEditableText *text,
                                                             gint start_pos,
                                                             gint end_pos);
    void                atk_editable_text_paste_text        (AtkEditableText *text,
                                                             gint position);

## Object Hierarchy

      GInterface
       +----AtkEditableText

## Known Implementations

AtkEditableText is implemented by AtkNoOpObject.

## Description

AtkEditableText should be implemented by UI components which contain text which the user can edit, via the AtkObject corresponding to that component (see AtkObject).

AtkEditableText is a subclass of AtkText, and as such, an object which implements AtkEditableText is by definition an AtkText implementor as well.

See also: AtkText

## Details

### AtkEditableText

    typedef struct _AtkEditableText AtkEditableText;

### atk_editable_text_set_run_attributes ()

    gboolean            atk_editable_text_set_run_attributes
                                                            (AtkEditableText *text,
                                                             AtkAttributeSet *attrib_set,
                                                             gint start_offset,
                                                             gint end_offset);

Sets the attributes for a specified range. See the ATK_ATTRIBUTE macros (such as ATK_ATTRIBUTE_LEFT_MARGIN) for examples of attributes that can be set. Note that other attributes that do not have corresponding ATK_ATTRIBUTE macros may also be set for certain text widgets.

`text` : | an AtkEditableText
`attrib_set` : | an AtkAttributeSet
`start_offset` : | start of range in which to set attributes
`end_offset` : | end of range in which to set attributes
Returns : | `TRUE` if attributes successfully set for the specified range, otherwise `FALSE`

### atk_editable_text_set_text_contents ()

    void                atk_editable_text_set_text_contents (AtkEditableText *text,
                                                             const gchar *string);

Set text contents of `text`.

`text` : | an AtkEditableText
`string` : | string to set for text contents of `text`

### atk_editable_text_insert_text ()

    void                atk_editable_text_insert_text       (AtkEditableText *text,
                                                             const gchar *string,
                                                             gint length,
                                                             gint *position);

Insert text at a given position.

`text` : | an AtkEditableText
`string` : | the text to insert
`length` : | the length of text to insert, in bytes
`position` : | The caller initializes this to the position at which to insert the text. After the call it points at the position after the newly inserted text.

### atk_editable_text_copy_text ()

    void                atk_editable_text_copy_text         (AtkEditableText *text,
                                                             gint start_pos,
                                                             gint end_pos);

Copy text from `start_pos` up to, but not including `end_pos` to the clipboard.

`text` : | an AtkEditableText
`start_pos` : | start position
`end_pos` : | end position

### atk_editable_text_cut_text ()

    void                atk_editable_text_cut_text          (AtkEditableText *text,
                                                             gint start_pos,
                                                             gint end_pos);

Copy text from `start_pos` up to, but not including `end_pos` to the clipboard and then delete from the widget.

`text` : | an AtkEditableText
`start_pos` : | start position
`end_pos` : | end position

### atk_editable_text_delete_text ()

    void                atk_editable_text_delete_text       (AtkEditableText *text,
                                                             gint start_pos,
                                                             gint end_pos);

Delete text `start_pos` up to, but not including `end_pos`.

`text` : | an AtkEditableText
`start_pos` : | start position
`end_pos` : | end position

### atk_editable_text_paste_text ()

    void                atk_editable_text_paste_text        (AtkEditableText *text,
                                                             gint position);

Paste text from clipboard to specified `position`.

`text` : | an AtkEditableText
`position` : | position to paste