GAIL Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
struct GailTextUtil; enum GailOffsetType; GailTextUtil* gail_text_util_new (void); void gail_text_util_text_setup (GailTextUtil *textutil, const gchar *text); void gail_text_util_buffer_setup (GailTextUtil *textutil, GtkTextBuffer *buffer); gchar* gail_text_util_get_text (GailTextUtil *textutil, gpointer layout, GailOffsetType function, AtkTextBoundary boundary_type, gint offset, gint *start_offset, gint *end_offset); gchar* gail_text_util_get_substring (GailTextUtil *textutil, gint start_pos, gint end_pos); |
GailTextUtil is a utility class which can be used to implement the AtkText functions which get text for accessible objects which implement AtkText. In GAIL it is used by the accsesible objects for GnomeCanvasText, GtkEntry, GtkLabel, GtkCellRendererText and GtkTextview.
struct GailTextUtil { GObject parent; GtkTextBuffer *buffer; }; |
The GailTextCell structure should not be accessed directly.
typedef enum { GAIL_BEFORE_OFFSET, GAIL_AT_OFFSET, GAIL_AFTER_OFFSET }GailOffsetType; |
Specifies which of the functions atk_text_get_text_before_offset(), atk_text_get_text_at_offset(), atk_text_get_text_after_offset() the function gail_text_util_get_text() is being called for.
Text before offset is required.
Text at offset is required,
Text after offset is required.
GailTextUtil* gail_text_util_new (void); |
This function creates a new GailTextUtil object.
the GailTextUtil object
void gail_text_util_text_setup (GailTextUtil *textutil, const gchar *text); |
This function initializes the GailTextUtil with the specified character string,
The GailTextUtil to be initialized.
A gchar* which points to the text to be stored in the GailTextUtil
void gail_text_util_buffer_setup (GailTextUtil *textutil, GtkTextBuffer *buffer); |
This function initializes the GailTextUtil with the specified GtkTextBuffer
A GailTextUtil to be initialized
The GtkTextBuffer which identifies the text to be stored in the GailUtil.
gchar* gail_text_util_get_text (GailTextUtil *textutil, gpointer layout, GailOffsetType function, AtkTextBoundary boundary_type, gint offset, gint *start_offset, gint *end_offset); |
This function gets the requested substring from the text in the GtkTextUtil. The layout is used only for getting the text on a line. The value is NULL for a GtkTextView which is not wrapped, is a GtkTextView for a GtkTextView which is wrapped and is a PangoLayout otherwise.
A gpointer which is a PangoLayout, a GtkTreeView of NULL
An enumeration specifying whether to return the text before, at, or after the offset.
The boundary type.
The offset of the text in the GailTextUtil
Address of location in which the start offset is returned
Address of location in which the end offset is returned
the substring requested
gchar* gail_text_util_get_substring (GailTextUtil *textutil, gint start_pos, gint end_pos); |
Gets the substring indicated by start_pos and end_pos
The start position of the substring
The end position of the substring.
the substring indicated by start_pos and end_pos