Pileus Git - ~andy/gtk/blob - gtk/gtkaccessible.c

   1 /* GTK - The GIMP Toolkit
   2  * Copyright 2001 Sun Microsystems Inc.
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 #include "config.h"
  21 #include <string.h>
  22
  23 #include "gtkwidget.h"
  24 #include "gtkintl.h"
  25 #include "gtkaccessible.h"
  26
  27 /**
  28  * SECTION:gtkaccessible
  29  * @Short_description: Accessibility support for widgets
  30  * @Title: GtkAccessible
  31  */
  32
  33
  34 static void gtk_accessible_real_connect_widget_destroyed (GtkAccessible *accessible);
  35
  36 G_DEFINE_TYPE (GtkAccessible, gtk_accessible, ATK_TYPE_OBJECT)
  37
  38 static void
  39 gtk_accessible_init (GtkAccessible *object)
  40 {
  41 }
  42
  43 static void
  44 gtk_accessible_class_init (GtkAccessibleClass *klass)
  45 {
  46   klass->connect_widget_destroyed = gtk_accessible_real_connect_widget_destroyed;
  47 }
  48
  49 /**
  50  * gtk_accessible_set_widget:
  51  * @accessible: a #GtkAccessible
  52  * @widget: a #GtkWidget
  53  *
  54  * Sets the #GtkWidget corresponding to the #GtkAccessible.
  55  *
  56  * Since: 2.22
  57  **/
  58 void
  59 gtk_accessible_set_widget (GtkAccessible *accessible,
  60                            GtkWidget     *widget)
  61 {
  62   g_return_if_fail (GTK_IS_ACCESSIBLE (accessible));
  63
  64   accessible->widget = widget;
  65 }
  66
  67 /**
  68  * gtk_accessible_get_widget:
  69  * @accessible: a #GtkAccessible
  70  *
  71  * Gets the #GtkWidget corresponding to the #GtkAccessible. The returned widget
  72  * does not have a reference added, so you do not need to unref it.
  73  *
  74  * Returns: (transfer none): pointer to the #GtkWidget corresponding to
  75  *   the #GtkAccessible, or %NULL.
  76  *
  77  * Since: 2.22
  78  **/
  79 GtkWidget*
  80 gtk_accessible_get_widget (GtkAccessible *accessible)
  81 {
  82   g_return_val_if_fail (GTK_IS_ACCESSIBLE (accessible), NULL);
  83
  84   return accessible->widget;
  85 }
  86
  87 /**
  88  * gtk_accessible_connect_widget_destroyed
  89  * @accessible: a #GtkAccessible
  90  *
  91  * This function specifies the callback function to be called when the widget
  92  * corresponding to a GtkAccessible is destroyed.
  93  */
  94 void
  95 gtk_accessible_connect_widget_destroyed (GtkAccessible *accessible)
  96 {
  97   GtkAccessibleClass *class;
  98
  99   g_return_if_fail (GTK_IS_ACCESSIBLE (accessible));
 100
 101   class = GTK_ACCESSIBLE_GET_CLASS (accessible);
 102
 103   if (class->connect_widget_destroyed)
 104     class->connect_widget_destroyed (accessible);
 105 }
 106
 107 static void
 108 gtk_accessible_real_connect_widget_destroyed (GtkAccessible *accessible)
 109 {
 110   if (accessible->widget)
 111   {
 112     g_signal_connect (accessible->widget,
 113                       "destroy",
 114                       G_CALLBACK (gtk_widget_destroyed),
 115                       &accessible->widget);
 116   }
 117 }