On May 11, 2010, at 12:52 PM, Christiaan Hofman wrote: On May 11, 2010, at 17:34, Bill Cheeseman wrote:
On May 11, 2010, at 10:21 AM, Christiaan Hofman wrote:
Thanks, that's indeed already an improvement to what existed before (but where are the cross links to this from the various other places?)
However, it's still very incomplete. I don't see a single parameterized attribute, and those are the ones that I was missing most.
I haven't scanned it exhaustively, but I see several of the parameterized text attributes just by glancing at it. E.g., AXAttributedStringForRange and AXBoundsForRange. They aren't called out in a separate section or labeled as "parameterized," so you have to look for them by name.
I only see those in the list of attributes. Nothing in the list of roles, and they also don't list roles for which they are required/optional. And that's what I'm looking for.
Christiaan
The parameterized attributes are labeled explicitly in the AX... and NSAccessibility... header files, so you can start there to get an exhaustive list of what to search the reference document for.
Right you are. That's a good question for James Dempsey, then.
I found the following statements in the "Accessibility Overview" document, just after the table of attributes supported by AXTextArea elements: " Note: A text area object also supports parameterized attributes. See the framework-specific documentation for more information on these attributes." I take that to mean "required," because the next sentence says the element "can" support a certain action, where "can" presumably means "optional." But this certainly is a little ambiguous. A similar quotation appears after the AXTextField table. I haven't followed up by looking at the framework-specific documentation.
Interestingly, although the "Roles and Attributes" reference was published only a few weeks ago, it does not mention any of the new Snow Leopard parameterized attributes for cell-based tables and layout areas. However, the NSAccessibility Protocol Reference does list them. In one -- and only one -- instance, it provides the kind of information about them that you are looking for: the entry for NSAccessibilityCellForColumnAndRowParameterizedAttribute says "This attribute is required for cell-based tables." |