Re: Text Attribute API revisions

["Padraig O'Briain" <Padraig Obriain Sun COM>]

When we come to update the source and include files, startOffset and endOffset 
should be start_offset and end_offset.

Padraig

> Delivered-To: gnome-accessibility-list gnome org
> Subject: Text Attribute API revisions
> To: gnome-accessibility-list gnome org
> MIME-Version: 1.0
> Content-MD5: obDWX7OFHWr7m9DSLhuSkg==
> X-BeenThere: gnome-accessibility-list gnome org
> X-Loop: gnome-accessibility-list gnome org
> X-Mailman-Version: 2.0.5
> List-Help: <mailto:gnome-accessibility-list-request gnome org?subject=help>
> List-Post: <mailto:gnome-accessibility-list gnome org>
> List-Subscribe: 
<http://mail.gnome.org/mailman/listinfo/gnome-accessibility-list>, 
<mailto:gnome-accessibility-list-request gnome org?subject=subscribe>
> List-Id: GNOME accessibility development <gnome-accessibility-list.gnome.org>
> List-Unsubscribe: 
<http://mail.gnome.org/mailman/listinfo/gnome-accessibility-list>, 
<mailto:gnome-accessibility-list-request gnome org?subject=unsubscribe>
> List-Archive: <http://mail.gnome.org/archives/gnome-accessibility-list/>
> 
> Brian and I talked about ATK text attribute interfaces and recent discussion 
on the 
> list about attribute runs.
> 
> We came up with the following proposals for the API:
> 
> gchar * 
> atk_text_get_text_(at,before.after)_offset ( AtkText *text, 
>                                              gint offset,
>                                              AtkTextBoundary boundary_type,
>                                              gint *startOffset,
>                                              gint *endOffset);
> 
> [Note the addition of two "out" parameters startOffset and endOffset: they 
will 
> provide the offset range of the returned character string, for convenience.]
> 
> AtkAttributeSet * 
> atk_text_get_attribute_bounds (text, offset, &startOffset, &endOffset);
> 
> This will return a set of attributes that apply to the character at the 
current 
> offset, and also indicate the starting and ending offsets of the substring 
over 
> which these attributes are invariant.
> 
> Typically the attribute run bounds returned by the above function will be 
compared 
> with those returned by the atk_text_get_text_at_...() methods, in case the AT 
needs 
> to segment the returned character string into attribute runs: alternatively 
the 
> segmentation could be done by calling atk_text_get_text() with the appropriate 
> offsets.
> 
> We propose that AtkAttributeSet be implemented as string-based name-value 
pairs, and 
> that we standardize as much as possible the names of "keys" and their common 
values. 
>  The returned strings can then be localized for use by AT clients.
> 
> regards,
> 
> -Bill
> 
> ------
> Bill Haneman x19279
> Gnome Accessibility / Batik SVG Toolkit
> Sun Microsystems Ireland 
> 
> 
> _______________________________________________
> gnome-accessibility-list mailing list
> gnome-accessibility-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-accessibility-list