1 /* ATK - Accessibility Toolkit
2 * Copyright 2007 Sun Microsystems Inc.
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.
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.
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.
22 static void atk_misc_class_init (AtkMiscClass *klass);
25 atk_misc_get_type (void)
27 static GType type = 0;
31 static const GTypeInfo typeInfo =
33 sizeof (AtkMiscClass),
35 (GBaseFinalizeFunc) NULL,
36 (GClassInitFunc) atk_misc_class_init,
37 (GClassFinalizeFunc) NULL,
41 (GInstanceInitFunc) NULL,
43 type = g_type_register_static (G_TYPE_OBJECT, "AtkMisc", &typeInfo, 0) ;
49 atk_misc_class_init (AtkMiscClass *klass)
51 klass->threads_enter = NULL;
52 klass->threads_leave = NULL;
56 * atk_misc_threads_enter:
57 * @misc: an AtkMisc instance for this application.
59 * Take the thread mutex for the GUI toolkit,
61 * (This method is implemented by the toolkit ATK implementation layer;
62 * for instance, for GTK+, GAIL implements this via GDK_THREADS_ENTER).
68 atk_misc_threads_enter (AtkMisc *misc)
70 AtkMiscClass *klass = ATK_MISC_GET_CLASS (misc);
71 if (klass->threads_enter)
73 klass->threads_enter (misc);
78 * atk_misc_threads_leave:
79 * @misc: an AtkMisc instance for this application.
81 * Release the thread mutex for the GUI toolkit,
82 * if one exists. This method, and atk_misc_threads_enter,
83 * are needed in some situations by threaded application code which
84 * services ATK requests, since fulfilling ATK requests often
85 * requires calling into the GUI toolkit. If a long-running or
86 * potentially blocking call takes place inside such a block, it should
87 * be bracketed by atk_misc_threads_leave/atk_misc_threads_enter calls.
88 * (This method is implemented by the toolkit ATK implementation layer;
89 * for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE).
95 atk_misc_threads_leave (AtkMisc *misc)
97 AtkMiscClass *klass = ATK_MISC_GET_CLASS (misc);
98 if (klass->threads_leave)
100 klass->threads_leave (misc);
104 AtkMisc *atk_misc_instance = NULL;
107 * atk_misc_get_instance:
109 * Obtain the singleton instance of AtkMisc for this application.
113 * Returns: The singleton instance of AtkMisc for this application.
117 atk_misc_get_instance (void)
119 return atk_misc_instance;