atspi-collection

## atspi-collection atspi-collection — An interface designed to allow accessibles which satisfy a set of criteria to be returned. |

## Synopsis

                        AtspiCollection;
    gboolean            atspi_collection_is_ancestor_of     (AtspiCollection *collection,
                                                             AtspiAccessible *test,
                                                             GError **error);
    GArray *            atspi_collection_get_matches        (AtspiCollection *collection,
                                                             AtspiMatchRule *rule,
                                                             AtspiCollectionSortOrder sortby,
                                                             gint count,
                                                             gboolean traverse,
                                                             GError **error);
    GArray *            atspi_collection_get_matches_to     (AtspiCollection *collection,
                                                             AtspiAccessible *current_object,
                                                             AtspiMatchRule *rule,
                                                             AtspiCollectionSortOrder sortby,
                                                             AtspiCollectionTreeTraversalType tree,
                                                             gboolean limit_scope,
                                                             gint count,
                                                             gboolean traverse,
                                                             GError **error);
    GArray *            atspi_collection_get_matches_from   (AtspiCollection *collection,
                                                             AtspiAccessible *current_object,
                                                             AtspiMatchRule *rule,
                                                             AtspiCollectionSortOrder sortby,
                                                             AtspiCollectionTreeTraversalType tree,
                                                             gint count,
                                                             gboolean traverse,
                                                             GError **error);
    AtspiAccessible *   atspi_collection_get_active_descendant
                                                            (AtspiCollection *collection,
                                                             GError **error);

## Object Hierarchy

      GInterface
       +----AtspiCollection

## Known Implementations

AtspiCollection is implemented by AtspiAccessible.

## Description

An interface designed to allow accessibles which satisfy a set of criteria to be returned. This interface can be used to avoid iteration or client-side search of the object tree.

## Details

### AtspiCollection

    typedef struct _AtspiCollection AtspiCollection;

### atspi_collection_is_ancestor_of ()

    gboolean            atspi_collection_is_ancestor_of     (AtspiCollection *collection,
                                                             AtspiAccessible *test,
                                                             GError **error);

Not yet implemented.

### atspi_collection_get_matches ()

    GArray *            atspi_collection_get_matches        (AtspiCollection *collection,
                                                             AtspiMatchRule *rule,
                                                             AtspiCollectionSortOrder sortby,
                                                             gint count,
                                                             gboolean traverse,
                                                             GError **error);

`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`: Not supported.

Gets all AtspiAccessible objects from the `collection` matching a given `rule`.

Returns : | All AtspiAccessible objects matching the given match rule. [element-type AtspiAccessible*][transfer full]

### atspi_collection_get_matches_to ()

    GArray *            atspi_collection_get_matches_to     (AtspiCollection *collection,
                                                             AtspiAccessible *current_object,
                                                             AtspiMatchRule *rule,
                                                             AtspiCollectionSortOrder sortby,
                                                             AtspiCollectionTreeTraversalType tree,
                                                             gboolean limit_scope,
                                                             gint count,
                                                             gboolean traverse,
                                                             GError **error);

`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.

`limit_scope`: If TRUE, only descendants of `current_object`'s parent will be returned. Otherwise (if FALSE), any accessible may be returned if it would preceed `current_object` in a flattened hierarchy.

`count`: The maximum number of results to return, or 0 for no limit.

`traverse`: Not supported.

Gets all AtspiAccessible objects from the `collection`, after `current_object`, matching a given `rule`.

Returns : | All AtspiAccessible objects matching the given match rule after `current_object`. [element-type AtspiAccessible*][transfer full]

### atspi_collection_get_matches_from ()

    GArray *            atspi_collection_get_matches_from   (AtspiCollection *collection,
                                                             AtspiAccessible *current_object,
                                                             AtspiMatchRule *rule,
                                                             AtspiCollectionSortOrder sortby,
                                                             AtspiCollectionTreeTraversalType tree,
                                                             gint count,
                                                             gboolean traverse,
                                                             GError **error);

`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`: Not supported.

Gets all AtspiAccessible objects from the `collection`, before `current_object`, matching a given `rule`.

Returns : | All AtspiAccessible objects matching the given match rule that preceed `current_object`. [element-type AtspiAccessible*][transfer full]

### atspi_collection_get_active_descendant ()

    AtspiAccessible *   atspi_collection_get_active_descendant
                                                            (AtspiCollection *collection,
                                                             GError **error);

Not yet implemented.