1901456 - [UIA] Support for querying plain text

Status: RESOLVED FIXED

(Core :: Disability Access APIs, task)

Description

[James Teh [:Jamie]]

This work will lay the foundations for supporting the UIA Text and TextRange patterns. This will involve the following:

1. Create a new object for UIA text ranges which can be constructed with a TextLeafRange and includes stubs for the ITextRangeProvider methods.
2. A strong reference cannot be held to a TextLeafRange. Therefore, add code to store and retrieve it.
3. Create a class to implement ITextProvider, inherited into ia2AccessibleHypertext. Support it only on editable text boxes for now and implement only ITextProvider::get_DocumentRange, with stubs for the other methods.
4. Implement ITextRangeProvider::GetText.
5. Implement ITextRangeProvider Clone, Compare, CompareEndpoints, ExpandToEnclosingUnit, Move, MoveEndpointByRange AND MoveEndpointByUnit. The Move and Expand methods should be restricted to the containing text box.

Comment 1

[James Teh [:Jamie]]

Attachment: Bug 1901456 part 1: Add stub ITextRangeProvider implementation.

Comment 2

[James Teh [:Jamie]]

Attachment: Bug 1901456 part 2: Store and reconstitute the TextLeafRange in UiaTextRange using MsaaAccessible strong references.

The root start and end points will later be used to restrict movement within the Accessible exposing the Text pattern from which the range was created.

Comment 3

[James Teh [:Jamie]]

Attachment: Bug 1901456 part 3: Implement ITextProvider::get_DocumentRange for editable text controls, with stubs for the other ITextProvider methods.

Unfortunately, this can't be usefully tested without implementing another method, so tests will come in the next patch.

Comment 4

[James Teh [:Jamie]]

Attachment: Bug 1901456 part 4: Implement ITextRangeProvider::GetText.

Comment 5

[James Teh [:Jamie]]

Attachment: Bug 1901456 part 5: Provide a way to safely get a TextLeafRange from an ITextRangeProvider pointer provided by a client.

This will be needed for the Compare, CompareEndpoints and MoveEndpointByRange methods.

Comment 6

[James Teh [:Jamie]]

Attachment: Bug 1901456 part 6: Implement ITextRangeProvider Clone, Compare, CompareEndpoints, ExpandToEnclosingUnit, Move, MoveEndpointByRange AND MoveEndpointByUnit methods.

Comment 8

[James Teh [:Jamie]]

I'm rolling documents into this as well. See bug 1901458 comment 2 for details.

Comment 9

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/fc3cc31ee8f7
part 1: Add stub ITextRangeProvider implementation. r=nlapre
https://hg.mozilla.org/integration/autoland/rev/b3c3b5cc473e
part 2: Store and reconstitute the TextLeafRange in UiaTextRange using MsaaAccessible strong references. r=nlapre
https://hg.mozilla.org/integration/autoland/rev/a50db51f3a76
part 3: Implement ITextProvider::get_DocumentRange for editable text controls, with stubs for the other ITextProvider methods. r=nlapre
https://hg.mozilla.org/integration/autoland/rev/afaeb26a2c16
part 4: Implement ITextRangeProvider::GetText. r=nlapre
https://hg.mozilla.org/integration/autoland/rev/eae561f4bb0a
part 5: Provide a way to safely get a TextLeafRange from an ITextRangeProvider pointer provided by a client. r=nlapre
https://hg.mozilla.org/integration/autoland/rev/7f421023d32a
part 6: Implement ITextRangeProvider Clone, Compare, CompareEndpoints, ExpandToEnclosingUnit, Move, MoveEndpointByRange AND MoveEndpointByUnit methods. r=nlapre

Comment 10

[Cristian Tuns]

https://hg.mozilla.org/mozilla-central/rev/fc3cc31ee8f7
https://hg.mozilla.org/mozilla-central/rev/b3c3b5cc473e
https://hg.mozilla.org/mozilla-central/rev/a50db51f3a76
https://hg.mozilla.org/mozilla-central/rev/afaeb26a2c16
https://hg.mozilla.org/mozilla-central/rev/eae561f4bb0a
https://hg.mozilla.org/mozilla-central/rev/7f421023d32a