/* ATK -  Accessibility Toolkit

 * Copyright 2001 Sun Microsystems Inc.

 *

 * This library is free software; you can redistribute it and/or

 * modify it under the terms of the GNU Lesser General Public

 * License as published by the Free Software Foundation; either

 * version 2 of the License, or (at your option) any later version.

 *

 * This library is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

 * Lesser General Public License for more details.

 *

 * You should have received a copy of the GNU Lesser General Public

 * License along with this library; if not, write to the

 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,

 * Boston, MA 02111-1307, USA.

 */

#include "config.h"

#include <locale.h>

#include <string.h>

#include <glib-object.h>

#include <glib/gi18n-lib.h>

#include "atk.h"

#include "atkmarshal.h"

#include "atkprivate.h"

/**

 * AtkObject:

 *

 * The base object class for the Accessibility Toolkit API.

 *

 * This class is the primary class for accessibility support via the

 * Accessibility ToolKit (ATK).  Objects which are instances of

 * #AtkObject (or instances of AtkObject-derived types) are queried

 * for properties which relate basic (and generic) properties of a UI

 * component such as name and description.  Instances of #AtkObject

 * may also be queried as to whether they implement other ATK

 * interfaces (e.g. #AtkAction, #AtkComponent, etc.), as appropriate

 * to the role which a given UI component plays in a user interface.

 *

 * All UI components in an application which provide useful

 * information or services to the user must provide corresponding

 * #AtkObject instances on request (in GTK+, for instance, usually on

 * a call to #gtk_widget_get_accessible ()), either via ATK support

 * built into the toolkit for the widget class or ancestor class, or

 * in the case of custom widgets, if the inherited #AtkObject

 * implementation is insufficient, via instances of a new #AtkObject

 * subclass.

 *

 * See [class@AtkObjectFactory], [class@AtkRegistry].  (GTK+ users see also

 * #GtkAccessible).

 *

 */

static GPtrArray *role_names = NULL;

enum

{

  PROP_0, /* gobject convention */

  PROP_NAME,

  PROP_DESCRIPTION,

  PROP_PARENT, /* ancestry has changed */

  PROP_VALUE,

  PROP_ROLE,

  PROP_LAYER,

  PROP_MDI_ZORDER,

  PROP_TABLE_CAPTION,

  PROP_TABLE_COLUMN_DESCRIPTION,

  PROP_TABLE_COLUMN_HEADER,

  PROP_TABLE_ROW_DESCRIPTION,

  PROP_TABLE_ROW_HEADER,

  PROP_TABLE_SUMMARY,

  PROP_TABLE_CAPTION_OBJECT,

  PROP_HYPERTEXT_NUM_LINKS,

  PROP_ACCESSIBLE_ID,

  PROP_HELP_TEXT,

  PROP_LAST /* gobject convention */

};

enum

{

  CHILDREN_CHANGED,

  FOCUS_EVENT,

  PROPERTY_CHANGE,

  STATE_CHANGE,

  VISIBLE_DATA_CHANGED,

  ACTIVE_DESCENDANT_CHANGED,

  ANNOUNCEMENT,

  NOTIFICATION,

  ATTRIBUTE_CHANGED,

  LAST_SIGNAL

};

typedef struct

{

  gchar *accessible_id;

  gchar *help_text;

} AtkObjectPrivate;

static gint AtkObject_private_offset;

static void atk_object_class_init (AtkObjectClass *klass);

static void atk_object_init (AtkObject *accessible,

                             AtkObjectClass *klass);

static AtkRelationSet *atk_object_real_ref_relation_set (AtkObject *accessible);

static void atk_object_real_initialize (AtkObject *accessible,

                                        gpointer data);

static void atk_object_real_set_property (GObject *object,

                                          guint prop_id,

                                          const GValue *value,

                                          GParamSpec *pspec);

static void atk_object_real_get_property (GObject *object,

                                          guint prop_id,

                                          GValue *value,

                                          GParamSpec *pspec);

static void atk_object_finalize (GObject *object);

static const gchar *atk_object_real_get_name (AtkObject *object);

static const gchar *atk_object_real_get_description (AtkObject *object);

static AtkObject *atk_object_real_get_parent (AtkObject *object);

static AtkRole atk_object_real_get_role (AtkObject *object);

static AtkLayer atk_object_real_get_layer (AtkObject *object);

static AtkStateSet *atk_object_real_ref_state_set (AtkObject *object);

static void atk_object_real_set_name (AtkObject *object,

                                      const gchar *name);

static void atk_object_real_set_description (AtkObject *object,

                                             const gchar *description);

static void atk_object_real_set_parent (AtkObject *object,

                                        AtkObject *parent);

static void atk_object_real_set_role (AtkObject *object,

                                      AtkRole role);

static void atk_object_notify (GObject *obj,

                               GParamSpec *pspec);

static const gchar *atk_object_real_get_object_locale (AtkObject *object);

static guint atk_object_signals[LAST_SIGNAL] = {

  0,

};

static gpointer parent_class = NULL;

static const gchar *const atk_object_name_property_name = "accessible-name";

static const gchar *const atk_object_name_property_description = "accessible-description";

static const gchar *const atk_object_name_property_parent = "accessible-parent";

static const gchar *const atk_object_name_property_value = "accessible-value";

static const gchar *const atk_object_name_property_role = "accessible-role";

static const gchar *const atk_object_name_property_component_layer = "accessible-component-layer";

static const gchar *const atk_object_name_property_component_mdi_zorder = "accessible-component-mdi-zorder";

static const gchar *const atk_object_name_property_table_caption = "accessible-table-caption";

static const gchar *const atk_object_name_property_table_column_description = "accessible-table-column-description";

static const gchar *const atk_object_name_property_table_column_header = "accessible-table-column-header";

static const gchar *const atk_object_name_property_table_row_description = "accessible-table-row-description";

static const gchar *const atk_object_name_property_table_row_header = "accessible-table-row-header";

static const gchar *const atk_object_name_property_table_summary = "accessible-table-summary";

static const gchar *const atk_object_name_property_table_caption_object = "accessible-table-caption-object";

static const gchar *const atk_object_name_property_hypertext_num_links = "accessible-hypertext-nlinks";

static const gchar *const atk_object_name_property_accessible_id = "accessible-id";

static const gchar *const atk_object_name_property_help_text = "accessible-help-text";

static void

{

  GTypeClass *enum_class;

  GEnumValue *enum_value;

  int i;

    {

      // We want the role names to be in the format "check button" and not "check-button"

    }

}

GType

{

  static GType type = 0;

    {

      static const GTypeInfo typeInfo = {

        sizeof (AtkObjectClass),

        (GBaseInitFunc) NULL,

        (GBaseFinalizeFunc) NULL,

        (GClassInitFunc) atk_object_class_init,

        (GClassFinalizeFunc) NULL,

        NULL,

        sizeof (AtkObject),

        0,

        (GInstanceInitFunc) atk_object_init,

      };

    }

}

static inline gpointer

{

}

static void

{

  /*

   * We do not define default signal handlers here

   */

                                   PROP_NAME,

                                   g_param_spec_string (atk_object_name_property_name,

                                                        _ ("Accessible Name"),

                                                        _ ("Object instance’s name formatted for assistive technology access"),

                                                        NULL,

                                                        G_PARAM_READWRITE));

                                   PROP_DESCRIPTION,

                                   g_param_spec_string (atk_object_name_property_description,

                                                        _ ("Accessible Description"),

                                                        _ ("Description of an object, formatted for assistive technology access"),

                                                        NULL,

                                                        G_PARAM_READWRITE));

                                   PROP_PARENT,

                                   g_param_spec_object (atk_object_name_property_parent,

                                                        _ ("Accessible Parent"),

                                                        _ ("Parent of the current accessible as returned by atk_object_get_parent()"),

                                                        ATK_TYPE_OBJECT,

                                                        G_PARAM_READWRITE));

  /**

   * AtkObject:accessible-value:

   *

   * Numeric value of this object, in case being and AtkValue.

   *

   * Deprecated: Since 2.12. Use atk_value_get_value_and_text() to get

   * the value, and value-changed signal to be notified on their value

   * changes.

   */

                                   PROP_VALUE,

                                   g_param_spec_double (atk_object_name_property_value,

                                                        _ ("Accessible Value"),

                                                        _ ("Is used to notify that the value has changed"),

                                                        0.0,

                                                        G_MAXDOUBLE,

                                                        0.0,

                                                        G_PARAM_READWRITE));

                                   PROP_ROLE,

                                   g_param_spec_enum (atk_object_name_property_role,

                                                      _ ("Accessible Role"),

                                                      _ ("The accessible role of this object"),

                                                      ATK_TYPE_ROLE,

                                                      ATK_ROLE_UNKNOWN,

                                                      G_PARAM_READWRITE));

                                   PROP_LAYER,

                                   g_param_spec_int (atk_object_name_property_component_layer,

                                                     _ ("Accessible Layer"),

                                                     _ ("The accessible layer of this object"),

                                                     0,

                                                     G_MAXINT,

                                                     0,

                                                     G_PARAM_READABLE));

                                   PROP_MDI_ZORDER,

                                   g_param_spec_int (atk_object_name_property_component_mdi_zorder,

                                                     _ ("Accessible MDI Value"),

                                                     _ ("The accessible MDI value of this object"),

                                                     G_MININT,

                                                     G_MAXINT,

                                                     G_MININT,

                                                     G_PARAM_READABLE));

  /**

   * AtkObject:accessible-table-caption:

   *

   * Table caption.

   *

   * Deprecated: Since 1.3. Use table-caption-object instead.

   */

                                   PROP_TABLE_CAPTION,

                                   g_param_spec_string (atk_object_name_property_table_caption,

                                                        _ ("Accessible Table Caption"),

                                                        _ ("Is used to notify that the table caption has changed; this property should not be used. accessible-table-caption-object should be used instead"),

                                                        NULL,

                                                        G_PARAM_READWRITE));

  /**

   * AtkObject:accessible-table-column-header:

   *

   * Accessible table column header.

   *

   * Deprecated: Since 2.12. Use atk_table_get_column_header() and

   * atk_table_set_column_header() instead.

   */

                                   PROP_TABLE_COLUMN_HEADER,

                                   g_param_spec_object (atk_object_name_property_table_column_header,

                                                        _ ("Accessible Table Column Header"),

                                                        _ ("Is used to notify that the table column header has changed"),

                                                        ATK_TYPE_OBJECT,

                                                        G_PARAM_READWRITE));

  /**

   * AtkObject:accessible-table-column-description:

   *

   * Accessible table column description.

   *

   * Deprecated: Since 2.12. Use atk_table_get_column_description()

   * and atk_table_set_column_description() instead.

   */

                                   PROP_TABLE_COLUMN_DESCRIPTION,

                                   g_param_spec_string (atk_object_name_property_table_column_description,

                                                        _ ("Accessible Table Column Description"),

                                                        _ ("Is used to notify that the table column description has changed"),

                                                        NULL,

                                                        G_PARAM_READWRITE));

  /**

   * AtkObject:accessible-table-row-header:

   *

   * Accessible table row header.

   *

   * Deprecated: Since 2.12. Use atk_table_get_row_header() and

   * atk_table_set_row_header() instead.

   */

                                   PROP_TABLE_ROW_HEADER,

                                   g_param_spec_object (atk_object_name_property_table_row_header,

                                                        _ ("Accessible Table Row Header"),

                                                        _ ("Is used to notify that the table row header has changed"),

                                                        ATK_TYPE_OBJECT,

                                                        G_PARAM_READWRITE));

  /**

   * AtkObject:accessible-table-row-description:

   *

   * Accessible table row description.

   *

   * Deprecated: Since 2.12. Use atk_table_get_row_description() and

   * atk_table_set_row_description() instead.

   */

                                   PROP_TABLE_ROW_DESCRIPTION,

                                   g_param_spec_string (atk_object_name_property_table_row_description,

                                                        _ ("Accessible Table Row Description"),

                                                        _ ("Is used to notify that the table row description has changed"),

                                                        NULL,

                                                        G_PARAM_READWRITE));

                                   PROP_TABLE_SUMMARY,

                                   g_param_spec_object (atk_object_name_property_table_summary,

                                                        _ ("Accessible Table Summary"),

                                                        _ ("Is used to notify that the table summary has changed"),

                                                        ATK_TYPE_OBJECT,

                                                        G_PARAM_READWRITE));

                                   PROP_TABLE_CAPTION_OBJECT,

                                   g_param_spec_object (atk_object_name_property_table_caption_object,

                                                        _ ("Accessible Table Caption Object"),

                                                        _ ("Is used to notify that the table caption has changed"),

                                                        ATK_TYPE_OBJECT,

                                                        G_PARAM_READWRITE));

                                   PROP_HYPERTEXT_NUM_LINKS,

                                   g_param_spec_int (atk_object_name_property_hypertext_num_links,

                                                     _ ("Number of Accessible Hypertext Links"),

                                                     _ ("The number of links which the current AtkHypertext has"),

                                                     0,

                                                     G_MAXINT,

                                                     0,

                                                     G_PARAM_READABLE));

                                   PROP_ACCESSIBLE_ID,

                                   g_param_spec_string (atk_object_name_property_accessible_id,

                                                        _ ("Accessible ID"),

                                                        _ ("ID for the accessible; useful for automated testing"),

                                                        NULL,

                                                        G_PARAM_READWRITE));

                                   PROP_HELP_TEXT,

                                   g_param_spec_string (atk_object_name_property_help_text,

                                                        _ ("Help text"),

                                                        _ ("Help text associated with the accessible"),

                                                        NULL,

                                                        G_PARAM_READWRITE));

  /**

   * AtkObject::children-changed:

   * @atkobject: the object which received the signal.

   * @arg1: The index of the added or removed child. The value can be

   * -1. This is used if the value is not known by the implementor

   * when the child is added/removed or irrelevant.

   * @arg2: (type AtkObject): A gpointer to the child AtkObject which was added or

   * removed. If the child was removed, it is possible that it is not

   * available for the implementor. In that case this pointer can be

   * NULL.

   *

   * The signal "children-changed" is emitted when a child is added or

   * removed from an object. It supports two details: "add" and

   * "remove"

   */

                    G_TYPE_FROM_CLASS (klass),

                    G_SIGNAL_RUN_LAST | G_SIGNAL_DETAILED,

                    G_STRUCT_OFFSET (AtkObjectClass, children_changed),

                    NULL, NULL,

                    g_cclosure_marshal_VOID__UINT_POINTER,

                    G_TYPE_NONE,

                    2, G_TYPE_UINT, G_TYPE_POINTER);

  /**

   * AtkObject::focus-event:

   * @atkobject: the object which received the signal

   * @arg1: a boolean value which indicates whether the object gained

   * or lost focus.

   *

   * The signal "focus-event" is emitted when an object gained or lost

   * focus.

   *

   * Deprecated: 2.9.4: Use the #AtkObject::state-change signal instead.

   */

                    G_TYPE_FROM_CLASS (klass),

                    G_SIGNAL_RUN_LAST,

                    G_STRUCT_OFFSET (AtkObjectClass, focus_event),

                    NULL, NULL,

                    g_cclosure_marshal_VOID__BOOLEAN,

                    G_TYPE_NONE,

                    1, G_TYPE_BOOLEAN);

  /**

   * AtkObject::property-change:

   * @atkobject: the object which received the signal.

   * @arg1: (type AtkPropertyValues): an #AtkPropertyValues containing the new

   * value of the property which changed.

   *

   * The signal "property-change" is emitted when an object's property

   * value changes. @arg1 contains an #AtkPropertyValues with the name

   * and the new value of the property whose value has changed. Note

   * that, as with GObject notify, getting this signal does not

   * guarantee that the value of the property has actually changed; it

   * may also be emitted when the setter of the property is called to

   * reinstate the previous value.

   *

   * Toolkit implementor note: ATK implementors should use

   * g_object_notify() to emit property-changed

   * notifications. #AtkObject::property-changed is needed by the

   * implementation of atk_add_global_event_listener() because GObject

   * notify doesn't support emission hooks.

   */

                    G_TYPE_FROM_CLASS (klass),

                    G_SIGNAL_RUN_LAST | G_SIGNAL_DETAILED,

                    G_STRUCT_OFFSET (AtkObjectClass, property_change),

                    (GSignalAccumulator) NULL, NULL,

                    g_cclosure_marshal_VOID__POINTER,

                    G_TYPE_NONE, 1,

                    G_TYPE_POINTER);

  /**

   * AtkObject::state-change:

   * @atkobject: the object which received the signal.

   * @arg1: The name of the state which has changed

   * @arg2: A boolean which indicates whether the state has been set or unset.

   *

   * The "state-change" signal is emitted when an object's state

   * changes.  The detail value identifies the state type which has

   * changed.

   */

                    G_TYPE_FROM_CLASS (klass),

                    G_SIGNAL_RUN_LAST | G_SIGNAL_DETAILED,

                    G_STRUCT_OFFSET (AtkObjectClass, state_change),

                    (GSignalAccumulator) NULL, NULL,

                    atk_marshal_VOID__STRING_BOOLEAN,

                    G_TYPE_NONE, 2,

                    G_TYPE_STRING,

                    G_TYPE_BOOLEAN);

  /**

   * AtkObject::visible-data-changed:

   * @atkobject: the object which received the signal.

   *

   * The "visible-data-changed" signal is emitted when the visual

   * appearance of the object changed.

   */

                    G_TYPE_FROM_CLASS (klass),

                    G_SIGNAL_RUN_LAST,

                    G_STRUCT_OFFSET (AtkObjectClass, visible_data_changed),

                    (GSignalAccumulator) NULL, NULL,

                    g_cclosure_marshal_VOID__VOID,

                    G_TYPE_NONE, 0);

  /**

   * AtkObject::active-descendant-changed:

   * @atkobject: the object which received the signal.

   * @arg1: (type AtkObject): the newly focused object.

   *

   * The "active-descendant-changed" signal is emitted by an object

   * which has the state ATK_STATE_MANAGES_DESCENDANTS when the focus

   * object in the object changes. For instance, a table will emit the

   * signal when the cell in the table which has focus changes.

   */

                    G_TYPE_FROM_CLASS (klass),

                    G_SIGNAL_RUN_LAST | G_SIGNAL_DETAILED,

                    G_STRUCT_OFFSET (AtkObjectClass, active_descendant_changed),

                    NULL, NULL,

                    g_cclosure_marshal_VOID__POINTER,

                    G_TYPE_NONE,

                    1, G_TYPE_POINTER);

  /**

   * AtkObject::announcement

   * @atkobject: the object which received the signal.

   * @arg1: the text to be announced.

   *

   * The "announcement" signal can be emitted to pass an announcement on to

   * be read by a screen reader.

   *

   * Depcrecated (2.50): Use AtkObject::notification instead.

   *

   * Since: 2.46

   */

                    G_TYPE_FROM_CLASS (klass),

                    G_SIGNAL_RUN_LAST,

                    0, /* no class handler in order to avoid breaking ABI */

                    NULL, NULL,

                    g_cclosure_marshal_VOID__STRING,

                    G_TYPE_NONE,

                    1, G_TYPE_STRING);

  /**

   * AtkObject::notification

   * @atkobject: the object which received the signal.

   * @arg1: the text to be announced.

   * @arg2: an #AtkLive specifying the politeness of the notification.

   * Should be either ATK_LIVE_POLITE or ATK_LIVE_ASSERTIVE.

   *

   * The "notification" signal can be emitted to pass an announcement on to

   * be read by a screen reader.

   *

   * Since: 2.50

   */

                    G_TYPE_FROM_CLASS (klass),

                    G_SIGNAL_RUN_LAST,

                    0, /* no class handler in order to avoid breaking ABI */

                    NULL, NULL,

                    atk_marshal_VOID__STRING_INT,

                    G_TYPE_NONE,

                    2, G_TYPE_STRING, G_TYPE_INT);

  /**

   * AtkObject::attribute-changed

   * @atkobject: the object which received the signal.

   * @arg1: the name of the attribute being modified, or %NULL if not

   *          available.

   * @arg2: the attribute's new value, or %null if not available.

   *

   * The "attribute-changed" signal should be emitted when one of an object's

   * attributes changes.

   *

   * Since: 2.52

   */

                    G_TYPE_FROM_CLASS (klass),

                    G_SIGNAL_RUN_LAST,

                    0, /* no class handler in order to avoid breaking ABI */

                    NULL, NULL,

                    atk_marshal_VOID__STRING_STRING,

                    G_TYPE_NONE,

                    2, G_TYPE_STRING, G_TYPE_STRING);

static void

                 AtkObjectClass *klass)

{

  private

GType

{

  static GType type = 0;

    {

      static const GTypeInfo typeInfo = {

        sizeof (AtkImplementorIface),

        (GBaseInitFunc) NULL,

        (GBaseFinalizeFunc) NULL,

      };

    }

}

/**

 * atk_object_get_name:

 * @accessible: an #AtkObject

 *

 * Gets the accessible name of the accessible.

 *

 * Returns: a character string representing the accessible name of the object.

 **/

const gchar *

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_get_description:

 * @accessible: an #AtkObject

 *

 * Gets the accessible description of the accessible.

 *

 * Returns: a character string representing the accessible description

 * of the accessible.

 *

 **/

const gchar *

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_get_parent:

 * @accessible: an #AtkObject

 *

 * Gets the accessible parent of the accessible. By default this is

 * the one assigned with atk_object_set_parent(), but it is assumed

 * that ATK implementors have ways to get the parent of the object

 * without the need of assigning it manually with

 * atk_object_set_parent(), and will return it with this method.

 *

 * If you are only interested on the parent assigned with

 * atk_object_set_parent(), use atk_object_peek_parent().

 *

 * Returns: (transfer none): an #AtkObject representing the accessible

 * parent of the accessible

 **/

AtkObject *

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_peek_parent:

 * @accessible: an #AtkObject

 *

 * Gets the accessible parent of the accessible, if it has been

 * manually assigned with atk_object_set_parent. Otherwise, this

 * function returns %NULL.

 *

 * This method is intended as an utility for ATK implementors, and not

 * to be exposed to accessible tools. See atk_object_get_parent() for

 * further reference.

 *

 * Returns: (transfer none): an #AtkObject representing the accessible

 * parent of the accessible if assigned

 **/

AtkObject *

{

}

/**

 * atk_object_get_n_accessible_children:

 * @accessible: an #AtkObject

 *

 * Gets the number of accessible children of the accessible.

 *

 * Returns: an integer representing the number of accessible children

 * of the accessible.

 **/

gint

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_ref_accessible_child:

 * @accessible: an #AtkObject

 * @i: a gint representing the position of the child, starting from 0

 *

 * Gets a reference to the specified accessible child of the object.

 * The accessible children are 0-based so the first accessible child is

 * at index 0, the second at index 1 and so on.

 *

 * Returns: (transfer full): an #AtkObject representing the specified

 * accessible child of the accessible.

 **/

AtkObject *

                                 gint i)

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_ref_relation_set:

 * @accessible: an #AtkObject

 *

 * Gets the #AtkRelationSet associated with the object.

 *

 * Returns: (transfer full): an #AtkRelationSet representing the relation set

 * of the object.

 **/

AtkRelationSet *

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_role_register:

 * @name: a character string describing the new role.

 *

 * Registers the role specified by @name. @name must be a meaningful

 * name. So it should not be empty, or consisting on whitespaces.

 *

 * Deprecated: Since 2.12. If your application/toolkit doesn't find a

 * suitable role for a specific object defined at #AtkRole, please

 * submit a bug in order to add a new role to the specification.

 *

 * Returns: an #AtkRole for the new role if added

 * properly. ATK_ROLE_INVALID in case of error.

 **/

AtkRole

{

    {

        {

        }

    }

}

/**

 * atk_object_get_role:

 * @accessible: an #AtkObject

 *

 * Gets the role of the accessible.

 *

 * Returns: an #AtkRole which is the role of the accessible

 **/

AtkRole

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_get_layer:

 * @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

 **/

AtkLayer

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_get_mdi_zorder:

 * @accessible: an #AtkObject

 *

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

 *

 **/

gint

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_ref_state_set:

 * @accessible: an #AtkObject

 *

 * Gets a reference to the state set of the accessible; the caller must

 * unreference it when it is no longer needed.

 *

 * Returns: (transfer full): a reference to an #AtkStateSet which is the state

 * set of the accessible

 **/

AtkStateSet *

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_get_index_in_parent:

 * @accessible: an #AtkObject

 *

 * Gets the 0-based index of this accessible in its parent; returns -1 if the

 * accessible does not have an accessible parent.

 *

 * Returns: an integer which is the index of the accessible in its parent

 **/

gint

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_set_name:

 * @accessible: an #AtkObject

 * @name: a character string to be set as the accessible name

 *

 * Sets the accessible name of the accessible. You can't set the name

 * to NULL. This is reserved for the initial value. In this aspect

 * NULL is similar to ATK_ROLE_UNKNOWN. If you want to set the name to

 * a empty value you can use "".

 **/

void

                     const gchar *name)

{

  AtkObjectClass *klass;

    {

      /* Do not notify for initial name setting. See bug 665870 */

    }

}

/**

 * atk_object_set_description:

 * @accessible: an #AtkObject

 * @description: a character string to be set as the accessible description

 *

 * Sets the accessible description of the accessible. You can't set

 * the description to NULL. This is reserved for the initial value. In

 * this aspect NULL is similar to ATK_ROLE_UNKNOWN. If you want to set

 * the name to a empty value you can use "".

 **/

void

                            const gchar *description)

{

  AtkObjectClass *klass;

    {

      /* Do not notify for initial name setting. See bug 665870 */

                         atk_object_name_property_description);

    }

}

/**

 * atk_object_set_parent:

 * @accessible: an #AtkObject

 * @parent: an #AtkObject to be set as the accessible parent

 *

 * Sets the accessible parent of the accessible. @parent can be NULL.

 **/

void

                       AtkObject *parent)

{

  AtkObjectClass *klass;

    {

    }

}

/**

 * atk_object_set_role:

 * @accessible: an #AtkObject

 * @role: an #AtkRole to be set as the role

 *

 * Sets the role of the accessible.

 **/

void

                     AtkRole role)

{

  AtkObjectClass *klass;

  AtkRole old_role;

    {

        {

            /* Do not notify for initial role setting */

        }

    }

}

/**

 * atk_object_connect_property_change_handler: (skip)

 * @accessible: an #AtkObject

 * @handler: a function to be called when a property changes its value

 *

 * Calls @handler on property changes.

 *

 * Returns: a #guint which is the handler id used in

 *   atk_object_remove_property_change_handler()

 *

 * Deprecated: 2.12: Connect directly to #AtkObject::property-change or

 *   the relevant #GObject::notify signal for each desired property.

 */

guint

                                            AtkPropertyChangeHandler *handler)

{

  AtkObjectClass *klass;

  else

}

/**

 * atk_object_remove_property_change_handler:

 * @accessible: an #AtkObject

 * @handler_id: a guint which identifies the handler to be removed.

 *

 * Removes a property change handler.

 *

 * Deprecated: 2.12: See atk_object_connect_property_change_handler()

 */

void

                                           guint handler_id)

{

  AtkObjectClass *klass;

}

/**

 * atk_object_notify_state_change:

 * @accessible: an #AtkObject

 * @state: an #AtkState whose state is changed

 * @value: a gboolean which indicates whether the state is being set on or off

 *

 * Emits a state-change signal for the specified state.

 *

 * Note that as a general rule when the state of an existing object changes,

 * emitting a notification is expected.

 **/

void

                                AtkState state,

                                gboolean value)

{

  const gchar *name;

                 g_quark_from_string (name),

                 name, value, NULL);

}

/**

 * atk_implementor_ref_accessible:

 * @implementor: The #GObject instance which should implement #AtkImplementorIface

 * if a non-null return value is required.

 *

 * Gets a reference to an object's #AtkObject implementation, if

 * the object implements #AtkObjectIface

 *

 * Returns: (transfer full): a reference to an object's #AtkObject

 * implementation

 */

AtkObject *

{

  AtkImplementorIface *iface;

}

/**

 * atk_object_get_attributes:

 * @accessible: An #AtkObject.

 *

 * Get a list of properties applied to this object as a whole, as an #AtkAttributeSet consisting of

 * name-value pairs. As such these attributes may be considered weakly-typed properties or annotations,

 * as distinct from strongly-typed object data available via other get/set methods.

 * Not all objects have explicit "name-value pair" #AtkAttributeSet properties.

 *

 * Since: 1.12

 *

 * Returns: (transfer full): an #AtkAttributeSet consisting of all

 * explicit properties/annotations applied to the object, or an empty

 * set if the object has no name-value pair attributes assigned to

 * it. This #atkattributeset should be freed by a call to

 * atk_attribute_set_free().

 */

AtkAttributeSet *

{

  AtkObjectClass *klass;

  else

}

static AtkRelationSet *

{

}

static void

                              guint prop_id,

                              const GValue *value,

                              GParamSpec *pspec)

{

  AtkObject *accessible;

    {

    }

static void

                              guint prop_id,

                              GValue *value,

                              GParamSpec *pspec)

{