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.

Details

AtkEditableText

typedef struct _AtkEditableText AtkEditableText;

The AtkEditableText structure does not contain any fields.


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

See Also

AtkText