+2004-11-22 Padraig O'Briain <padraig.obriain@sun.com>
+
+ * atk/atkobject.c: Replace DEPRECATED by @Deprecated in comments
+ to fix warning when documentation is generated.
+
+ * atk/atkrelation.[ch]:
+ * docs/tmpl/atkrelation.sgml: Add atk_relation_add_target.
+
+ * atk/atkrelationset.[ch]:
+ * atk/tmpl/atkrelationset.sgml: Add atk_relation_add_relation_by_type.
+
+ * docs/atk-sections.txt: Add atk_relation_add_target and
+ atk_relation_add_relation_by_type.
+
+ Fixes bug #158722.
+
2004-11-17 Padraig O'Briain <padraig.obriain@sun.com>
* configure.in: Use gmodule-no-export.pc, requires glib 2.5.7.
* @accessible: an #AtkObject
*
* Gets the layer of the accessible.
- * DEPRECATED: use atk_component_get_layer instead!
*
* Returns: an #AtkLayer which is the layer of the accessible
+ *
+ * @Deprecated: Use atk_component_get_layer instead.
**/
AtkLayer
atk_object_get_layer (AtkObject *accessible)
*
* Gets the zorder of the accessible. The value G_MININT will be returned
* if the layer of the accessible is not ATK_LAYER_MDI.
- * DEPRECATED: use atk_component_get_mdi_zorder instead!
*
* Returns: a gint which is the zorder of the accessible, i.e. the depth at
* which the component is shown in relation to other components in the same
* container.
+ *
+ * @Deprecated: Use atk_component_get_mdi_zorder instead.
**/
gint
atk_object_get_mdi_zorder (AtkObject *accessible)
g_ptr_array_remove (array, where_the_object_was);
}
+/**
+ * atk_relation_add_target:
+ * @relation: an #AtkRelation
+ * @target: an #AtkObject
+ *
+ * Adds the specified AtkObject to the target for the relation, if it is
+ * not already present.
+ **/
+void
+atk_relation_add_target (AtkRelation *relation,
+ AtkObject *target)
+{
+ guint i;
+
+ g_return_if_fail (ATK_IS_RELATION (relation));
+ g_return_if_fail (ATK_IS_OBJECT (target));
+
+ /* first check if target occurs in array ... */
+ for (i = 0; i < relation->target->len; i++)
+ if (g_ptr_array_index(relation->target, i) == target)
+ return;
+
+ g_ptr_array_add (relation->target, target);
+ g_object_weak_ref (G_OBJECT (target), (GWeakNotify) delete_object_while_in_relation, relation->target);
+}
+
static void
atk_relation_finalize (GObject *object)
{
* Returns the target list of a relation.
*/
GPtrArray* atk_relation_get_target (AtkRelation *relation);
+void atk_relation_add_target (AtkRelation *relation,
+ AtkObject *target);
+
#ifdef __cplusplus
}
G_OBJECT_CLASS (parent_class)->finalize (object);
}
+
+/**
+ * atk_relation_set_add_relation_by_type:
+ * @set: an #AtkRelationSet
+ * @relationship: an #AtkRelationType
+ * @target: an #AtkObject
+ *
+ * Add a new relation of the specified type with the specified target to
+ * the current relation set if the relation set does not contain a relation
+ * of that type. If it is does contain a relation of that typea the target
+ * is added to the relation.
+ **/
+void
+atk_relation_set_add_relation_by_type (AtkRelationSet *set,
+ AtkRelationType relationship,
+ AtkObject *target)
+{
+ AtkRelation *relation;
+
+ g_return_if_fail (ATK_IS_RELATION_SET (set));
+ g_return_if_fail (ATK_IS_OBJECT (target));
+
+ relation = atk_relation_set_get_relation_by_type (set,
+ relationship);
+ if (relation)
+ {
+ atk_relation_add_target (relation, target);
+ }
+ else
+ {
+ /* the relation hasn't been created yet ... */
+ relation = atk_relation_new (&target, 1, relationship);
+ atk_relation_set_add (set, relation);
+ g_object_unref(relation);
+ }
+}
+
gint i);
AtkRelation* atk_relation_set_get_relation_by_type (AtkRelationSet *set,
AtkRelationType relationship);
+void atk_relation_set_add_relation_by_type (AtkRelationSet *set,
+ AtkRelationType relationship,
+ AtkObject *target);
#ifdef __cplusplus
}
atk_relation_new
atk_relation_get_relation_type
atk_relation_get_target
+atk_relation_add_target
<SUBSECTION Standard>
ATK_RELATION
ATK_IS_RELATION
atk_relation_set_get_n_relations
atk_relation_set_get_relation
atk_relation_set_get_relation_by_type
+atk_relation_set_add_relation_by_type
<SUBSECTION Standard>
ATK_RELATION_SET
ATK_IS_RELATION_SET
@Returns:
+<!-- ##### FUNCTION atk_relation_add_target ##### -->
+<para>
+
+</para>
+
+@relation:
+@target:
+
+
<!-- ##### ARG AtkRelation:relation-type ##### -->
<para>
@Returns:
+<!-- ##### FUNCTION atk_relation_set_add_relation_by_type ##### -->
+<para>
+
+</para>
+
+@set:
+@relationship:
+@target:
+
+