From 6274c56be7c75bea224d55407d057fff497b3bdb Mon Sep 17 00:00:00 2001 From: Padraig O'Briain Date: Wed, 23 May 2001 10:10:01 +0000 Subject: [PATCH] Clarified behavior of atk_text_get_text_... interfaces Corrected name of status bar role --- ChangeLog | 6 ++++++ atk/atkobject.h | 4 ++-- atk/atktext.c | 22 +++++++++++++++++++++- 3 files changed, 29 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index 2a3ce12..313472b 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2001-05-23 Padraig O'Briain + + * atk/atkobject.h: Correct naming of role for status bar + * atk/atktext.c: + Clarify behaviour of atk_text_get_text_after/at/before_offset + Sun May 13 11:35:32 2001 Owen Taylor * autogen.sh (have_automake): Require libtool-1.4, automake-1.4p1. diff --git a/atk/atkobject.h b/atk/atkobject.h index 0e81d6e..76b5f5f 100755 --- a/atk/atkobject.h +++ b/atk/atkobject.h @@ -205,8 +205,8 @@ typedef enum /* An object used to get an integer or floating point number from the user */ ATK_ROLE_SPIN_BUTTON, /* An object which reports messages of minor importance to the user */ - ATK_STATUS_BAR, - /* An object used to rpesent information in terms of rows and columns. */ + ATK_ROLE_STATUSBAR, + /* An object used to represent information in terms of rows and columns. */ ATK_ROLE_TABLE, ATK_ROLE_TABLE_CELL, ATK_ROLE_TABLE_COLUMN_HEADER, diff --git a/atk/atktext.c b/atk/atktext.c index e8471e2..0b09096 100755 --- a/atk/atktext.c +++ b/atk/atktext.c @@ -151,6 +151,13 @@ atk_text_get_character_at_offset (AtkText *text, * @boundary_type: An #AtkTextBoundary * * Returns: the text after @offset up to the specified @boundary_type. + * If the boundary type is ATK_TEXT_BOUNDARY_WORD_START or + * ATK_TEXT_BOUNDARY_WORD_END part of a word may be returned. + * If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the start point + * will be the offset and will continue to the start of the next sentence. + * The first word may not be a complete word. Similarly for + * ATK_TEXT_BOUNDARY_SENTENCE_END, ATK_TEXT_BOUNDARY_LINE_START and + * ATK_TEXT_BOUNDARY_LINE_END **/ gchar* atk_text_get_text_after_offset (AtkText *text, @@ -177,6 +184,12 @@ atk_text_get_text_after_offset (AtkText *text, * @boundary_type: An #AtkTextBoundary * * Returns: the text at @offset up to the specified @boundary_type. + * If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START or + * ATK_TEXT_BOUNDARY_WORD_END a complete word is returned; + * if the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START or + * ATK_TEXT_BOUNDARY_SENTENCE_END a complete sentence + * is returned; if the boundary type is ATK_TEXT_BOUNDARY_LINE_START or + * ATK_TEXT_BOUNDARY_LINE_END a complete line is returned. **/ gchar* atk_text_get_text_at_offset (AtkText *text, @@ -202,7 +215,14 @@ atk_text_get_text_at_offset (AtkText *text, * @offset: position * @boundary_type: An #AtkTextBoundary * - * Returns: the text before @offset up to the specified @boundary_type. + * Returns: the text before @offset starting from the specified @boundary_type. + * If the boundary type is ATK_TEXT_BOUNDARY_WORD_START or + * ATK_TEXT_BOUNDARY_WORD_END part of a word may be returned. + * If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the start point + * will be at the start of the sentence, and will continue to the offset. + * The last word may not be a complete word. Similarly for + * ATK_TEXT_BOUNDARY_SENTENCE_END, ATK_TEXT_BOUNDARY_LINE_START and + * ATK_TEXT_BOUNDARY_LINE_END **/ gchar* atk_text_get_text_before_offset (AtkText *text, -- 2.7.4