The events related to IAAction, IAHyperlink, and IAHypertext need some
work. Let me start by listing all the possible events for IAAction
(superclass of IAHyperlink), IAHyperlink, and IAHypertext .
For IAAction there could be:
- nActions changed - this is currently
IA2_EVENT_HYPERLINK_NUMBER_OF_ANCHORS_CHANGED
- one or more descriptions changed
- one or more keyBindings changed
- one or more names changed
- one or more localizedNames changed
Questions:
- Should we rename NUMBER_OF_ANCHORS_CHANGED to
NUMBER_OF_ACTIONS_CHANGED? Or should we simply add
NUMBER_OF_ACTIONS_CHANGED?
- Do we need events for the latter four changes?
- If we do add events for those latter four, is the "one or more"
information good enough or do we need to provide getters to fetch the
indexes of the ones that changed?
For IAHyperlink there could be:
- one or more anchors changed
- one or more anchorTargets changed
- the startIndex changed - this is IA2_EVENT_HYPERLINK_START_INDEX_CHANGED
- the endIndex changed - this is IA2_EVENT_HYPERLINK_END_INDEX_CHANGED
- one or more links valid state changed
Questions:
- I see IAHyperlink::valid either needs to reflect whether or not all
the links are valid or be changed to have an [in] index parameter.
Please let me know if the new parameter is needed.
- Do we need events for the first two and the last one?
For IAHypertext there could be:
- nHyperlinks changed - this is IA2_EVENT_HYPERTEXT_NLINKS_CHANGED
- one or more hyperlinks changed
- the link text has been updated thus some prior values of
hyperlinkIndex will have changed - this is IA2_EVENT_HYPERTEXT_CHANGED
Questions:
- Do we need an event for the second one?
For the remaining three that currently exist, we either need to remove
them or add more getters to fetch information related to link selection
and link activation. I suspect they can be removed. Do you agree?
IA2_EVENT_HYPERTEXT_LINK_ACTIVATED
One of the links associated with the hypertext object has been
activated.
IA2_EVENT_HYPERLINK_SELECTED_LINK_CHANGED
The hyperlink selected state changed from selected to unselected or
from unselected to selected.
IA2_EVENT_HYPERTEXT_LINK_SELECTED
One of the links associated with the hypertext object has been
selected.
Thanks to Car for poking into this.
Pete
--
*Pete Brunet*
a11ysoft - Accessibility Architecture and Development
(512) 238-6967 (work), (512) 689-4155 (cell)
Skype: pete.brunet
IM: ptbrunet (AOL, Google), [email protected] (MSN)
http://www.a11ysoft.com/about/
Ionosphere: WS4G
_______________________________________________
Accessibility-ia2 mailing list
[email protected]
https://lists.linux-foundation.org/mailman/listinfo/accessibility-ia2