AtkEditableText

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

Functions

Types and Values

Object Hierarchy

    GInterface
    ╰── AtkEditableText

Known Implementations

AtkEditableText is implemented by AtkNoOpObject.

Includes

#include <atk/atk.h>

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

Functions

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.

Parameters

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 .

Parameters

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.

Parameters

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.

Parameters

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.

Parameters

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 .

Parameters

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 .

Parameters

text

an AtkEditableText

 

position

position to paste

 

Types and Values

AtkEditableText

typedef struct _AtkEditableText AtkEditableText;