On 6/03/2012 2:27 AM, Pete Brunet wrote:
HRESULT IAccessible2_2::targetsByRelationType (
[in] BSTR type,
[out, size_is(,*nTargets)] long **targets,
[out, retval] long *nTargets )
This does not have the extra [in] count parameter Jamie proposed so the
client doesn't need to know before the call how many targets there are.
As I explained before, the point of the requestedTargets count parameter
I proposed was to allow the client to only retrieve the first n targets
if desired. As I noted, if requestedTargets is 0, the client is
requesting all relations, so the client doesn't need to know how many
targets there are in advance. nTargets always returns the number of
targets in the array, so if requestedTargets > nTargets, it doesn't
matter; the client should just use nTargets always once the call returns.
So, to get just the first target, a client would call with
requestedTargets=1. If there are no targets, nTargets would be 0 and the
targets array would be empty or NULL. If there is at least one target,
nTargets would be 1 and the targets array would contain one entry.
Jamie
--
James Teh
Director, NV Access Limited
Email: [email protected]
Web site: http://www.nvaccess.org/
Phone: +61 7 5667 8372
_______________________________________________
Accessibility-ia2 mailing list
[email protected]
https://lists.linuxfoundation.org/mailman/listinfo/accessibility-ia2
