AccessibleRelations and RelationSets

AccessibleRelations and RelationSets

Functions

Types and Values

Description

Functions

AccessibleRelation_ref ()

void
AccessibleRelation_ref (AccessibleRelation *obj);

Increment the reference count for an AccessibleRelation object.

Parameters

obj

a pointer to the AccessibleRelation object on which to operate.

 

AccessibleRelation_unref ()

void
AccessibleRelation_unref (AccessibleRelation *obj);

Decrement the reference count for an AccessibleRelation object.

Parameters

obj

a pointer to the AccessibleRelation object on which to operate.

 

AccessibleRelation_getNTargets ()

int
AccessibleRelation_getNTargets (AccessibleRelation *obj);

Get the number of objects which this relationship has as its target objects (the subject is the Accessible from which this AccessibleRelation originated).

Parameters

obj

a pointer to the AccessibleRelation object to query.

 

Returns

a short integer indicating how many target objects which the originating Accessible object has the AccessibleRelation relationship with.


AccessibleRelation_getTarget ()

Accessible *
AccessibleRelation_getTarget (AccessibleRelation *obj,
                              int i);

Get the i -th target of a specified AccessibleRelation relationship.

Parameters

obj

a pointer to the AccessibleRelation object to query.

 

i

a (zero-index) integer indicating which (of possibly several) target is requested.

 

Returns

an Accessible which is the i -th object with which the originating Accessible has relationship specified in the AccessibleRelation object.


AccessibleRelation_getRelationType ()

AccessibleRelationType
AccessibleRelation_getRelationType (AccessibleRelation *obj);

Get the type of relationship represented by an AccessibleRelation.

Parameters

obj

a pointer to the AccessibleRelation object to query.

 

Returns

an AccessibleRelationType indicating the type of relation encapsulated in this AccessibleRelation object.

Types and Values

enum AccessibleRelationType

Describes the type of the relation

Members

SPI_RELATION_NULL

Not used, this is an invalid value for this enumeration.

 

SPI_RELATION_LABEL_FOR

Indicates an object is a label for one or more target objects.

 

SPI_RELATION_LABELED_BY

Indicates an object is labelled by one or more target objects.

 

SPI_RELATION_CONTROLLER_FOR

Indicates an object is an controller for one or more target objects.

 

SPI_RELATION_CONTROLLED_BY

Indicates an object controlled by one or more target objects.

 

SPI_RELATION_MEMBER_OF

Indicates an object is a member of a group of one or more target objects.

 

SPI_RELATION_NODE_CHILD_OF

Indicates an object is a cell in a treetable which is displayed because a cell in the same column is expanded and identifies that cell.

 

SPI_RELATION_EXTENDED

This value indicates that a relation other than those pre-specified by this version of AT-SPI is present.

 

SPI_RELATION_FLOWS_TO

Indicates that the object has content that flows logically to another AtkObject in a sequential way, (for instance text-flow).

 

SPI_RELATION_FLOWS_FROM

Indicates that the object has content that flows logically from another AtkObject in a sequential way, (for instance text-flow).

 

SPI_RELATION_SUBWINDOW_OF

Indicates a subwindow attached to a component but otherwise has no connection in the UI heirarchy to that component.

 

SPI_RELATION_EMBEDS

Indicates that the object visually embeds another object's content, i.e. this object's content flows around another's content.

 

SPI_RELATION_EMBEDDED_BY

Inverse of SPI_RELATION_EMBEDS, indicates that this object's content is visualy embedded in another object.

 

SPI_RELATION_POPUP_FOR

Indicates that an object is a popup for another object.

 

SPI_RELATION_PARENT_WINDOW_OF

Indicates that an object is a parent window of another object.

 

SPI_RELATION_DESCRIPTION_FOR

Indicates that an object provides descriptive information about another object; more verbose than SPI_RELATION_LABEL_FOR.

 

SPI_RELATION_DESCRIBED_BY

Indicates that another object provides descriptive information about this object; more verbose than SPI_RELATION_LABELLED_BY.

 

SPI_RELATION_NODE_PARENT_OF

Indicates an object is a cell in a treetable and is expanded to display other cells in the same column.

 

SPI_RELATION_LAST_DEFINED

Do not use, this is an implementation detail used to identify the size of this enumeration.