Accessibility/TextAttributes: Difference between revisions

Accessibility/TextAttributes (view source)

Revision as of 06:24, 19 November 2007

No change in size , 19 November 2007

no edit summary

Surkov.alexander

Confirmed users

1,396

edits

@@ Line 1: / Line 1: @@
 <small>[[Accessibility |<< Back to Accessibility Home Page]]</small>
+= Proposed API =
+== Summary ==
+Returns a collection of text attributes at the given offset. Calculates the range where returned attributes are stretched.
+  nsIPersistentProperties getTextAttributes(in long offset,
+                                            out long rangeStartOffset,
+                                            out long rangeEndOffset);
+== Parameters ==
+; offset
+: [in] the given offset
+; rangeStartOffset
+: [out] the start offset of the result range
+; rangeEndOffset
+: [out] the end offset of the result range
+== Return Value ==
+A collection of text attributes (the list of pairs consisted from name and value).
+== Questions ==
+* What is the range hierarchy: are range nested or consecutive? Let we have a text 'abc<b>def</b>ghi'. If ranges are nested then we have two ranges: (0,9) and (3,6). If ranges are consecutive then we have three ranges (0, 3), (3, 6) and (6, 9).
+* Should text attributes in a range be either relative to a parent (in the case of nested ranges) or previous (in the case of consecutive ranges) range or cumulative?
+= Events =
+== Summary ==
+When a certain text attribute is changed then 'EVENT_TEXT_ATTRIBUTE_CHANGED' event should be fired.
+== Questions ==
+* How will AT know what attribute has been changed? Should the getTextAttributes() method return only last changed attribute?
+* It's not clear how to track CSS style changes mapped to text attributes. Possibly some of those changes will lead accessible is recreated.
 = Attribute list =
@@ Line 145: / Line 186: @@
 | Yes (empty implies none)
 |}
-= Proposed API =
-== Summary ==
-Returns a collection of text attributes at the given offset. Calculates the range where returned attributes are stretched.
-  nsIPersistentProperties getTextAttributes(in long offset,
-                                            out long rangeStartOffset,
-                                            out long rangeEndOffset);
-== Parameters ==
-; offset
-: [in] the given offset
-; rangeStartOffset
-: [out] the start offset of the result range
-; rangeEndOffset
-: [out] the end offset of the result range
-== Return Value ==
-A collection of text attributes (the list of pairs consisted from name and value).
-== Questions ==
-* What is the range hierarchy: are range nested or consecutive? Let we have a text 'abc<b>def</b>ghi'. If ranges are nested then we have two ranges: (0,9) and (3,6). If ranges are consecutive then we have three ranges (0, 3), (3, 6) and (6, 9).
-* Should text attributes in a range be either relative to a parent (in the case of nested ranges) or previous (in the case of consecutive ranges) range or cumulative?
-= Events =
-== Summary ==
-When a certain text attribute is changed then 'EVENT_TEXT_ATTRIBUTE_CHANGED' event should be fired.
-== Questions ==
-* How will AT know what attribute has been changed? Should the getTextAttributes() method return only last changed attribute?
-* It's not clear how to track CSS style changes mapped to text attributes. Possibly some of those changes will lead accessible is recreated.
 = References =
 * [http://www.linux-foundation.org/en/Accessibility/IAccessible2/TextAttributes IA2 Text Attributes] - IAccessible2 Text Attributes Documentation

Accessibility/TextAttributes: Difference between revisions

Accessibility/TextAttributes (view source)

Revision as of 06:24, 19 November 2007

Navigation menu

Search