diff options
author | Aline Bessa <alibezz@gmail.com> | 2011-08-01 21:30:45 -0300 |
---|---|---|
committer | Mike Gorse <mgorse@novell.com> | 2011-08-23 21:38:21 -0500 |
commit | 30158927a4005822c4045d29ea59a974281a2b19 (patch) | |
tree | 96614bb96215788a1db356d09cd2ec1747e0ef4f /atspi/atspi-collection.c | |
parent | 4b65b5e83bb0c7afb4919eac0c9757d31ade536b (diff) | |
download | at-spi2-core-30158927a4005822c4045d29ea59a974281a2b19.tar.gz |
Improving atspi-collection documentation.
Diffstat (limited to 'atspi/atspi-collection.c')
-rw-r--r-- | atspi/atspi-collection.c | 49 |
1 files changed, 33 insertions, 16 deletions
diff --git a/atspi/atspi-collection.c b/atspi/atspi-collection.c index 5dd9bf8d..a40a453b 100644 --- a/atspi/atspi-collection.c +++ b/atspi/atspi-collection.c @@ -28,12 +28,7 @@ /** * atspi_collection_is_ancestor_of: * - * @collection: A pointer to the #AtspiCollection to test against. - * @test: The #AtspiAccessible to test. - * - * Not yet implemented. - * - * Returns: TRUE if @collection is an ancestor of @test; FALSE otherwise. + * Not yet implemented. * **/ gboolean @@ -109,14 +104,21 @@ return_accessibles (DBusMessage *message) * atspi_collection_get_matches: * * @collection: A pointer to the #AtspiCollection to query. + * * @rule: An #AtspiMatchRule describing the match criteria. + * * @sortby: An #AtspiCollectionSortOrder specifying the way the results are to * be sorted. + * * @count: The maximum number of results to return, or 0 for no limit. + * * @traverse: TODO * - * Returns: (element-type AtspiAccessible*) (transfer full): A #GArray of - * #AtspiAccessibles matching the given match rule. + * Gets all #AtspiAccessible objects from the @collection matching a given + * @rule. + * + * Returns: (element-type AtspiAccessible*) (transfer full): All + * #AtspiAccessible objects matching the given match rule. **/ GArray * atspi_collection_get_matches (AtspiCollection *collection, @@ -151,18 +153,28 @@ atspi_collection_get_matches (AtspiCollection *collection, * atspi_collection_get_matches_to: * * @collection: A pointer to the #AtspiCollection to query. + * * @current_object: The object at which to start searching. + * * @rule: An #AtspiMatchRule describing the match criteria. + * * @sortby: An #AtspiCollectionSortOrder specifying the way the results are to * be sorted. + * * @tree: An #AtspiCollectionTreeTraversalType specifying restrictions on * the objects to be traversed. + * * @recurse: TODO + * * @count: The maximum number of results to return, or 0 for no limit. + * * @traverse: TODO * - * Returns: (element-type AtspiAccessible*) (transfer full): A #GArray of - * #AtspiAccessibles matching the given match rule after + * Gets all #AtspiAccessible objects from the @collection, after + * @current_object, matching a given @rule. + * + * Returns: (element-type AtspiAccessible*) (transfer full): All + * #AtspiAccessible objects matching the given match rule after * @current_object. **/ GArray * @@ -207,17 +219,26 @@ atspi_collection_get_matches_to (AtspiCollection *collection, * atspi_collection_get_matches_from: * * @collection: A pointer to the #AtspiCollection to query. + * * @current_object: Upon reaching this object, searching should stop. + * * @rule: An #AtspiMatchRule describing the match criteria. + * * @sortby: An #AtspiCollectionSortOrder specifying the way the results are to * be sorted. + * * @tree: An #AtspiCollectionTreeTraversalType specifying restrictions on * the objects to be traversed. + * * @count: The maximum number of results to return, or 0 for no limit. + * * @traverse: TODO * - * Returns: (element-type AtspiAccessible*) (transfer full): A #GArray of - * #AtspiAccessibles matching the given match rule that preceed + * Gets all #AtspiAccessible objects from the @collection, before + * @current_object, matching a given @rule. + * + * Returns: (element-type AtspiAccessible*) (transfer full): All + * #AtspiAccessible objects matching the given match rule that preceed * @current_object. **/ GArray * @@ -257,10 +278,6 @@ atspi_collection_get_matches_from (AtspiCollection *collection, /** * atspi_collection_get_active_descendant: - * - @collection: A pointer to the #AtspiCollection to query. - * - * Returns: (transfer full): The active descendant of #collection. * * Not yet implemented. **/ |