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.
26 * @Short_description: A set of ATK utility functions for thread locking
29 * A set of utility functions for thread locking. This interface and
30 * all his related methods are deprecated since 2.12.
33 static void atk_misc_class_init (AtkMiscClass
*klass
);
36 atk_misc_get_type (void)
38 static GType type
= 0;
42 static const GTypeInfo typeInfo
=
44 sizeof (AtkMiscClass
),
46 (GBaseFinalizeFunc
) NULL
,
47 (GClassInitFunc
) atk_misc_class_init
,
48 (GClassFinalizeFunc
) NULL
,
52 (GInstanceInitFunc
) NULL
,
54 type
= g_type_register_static (G_TYPE_OBJECT
, "AtkMisc", &typeInfo
, 0) ;
60 atk_misc_class_init (AtkMiscClass
*klass
)
62 klass
->threads_enter
= NULL
;
63 klass
->threads_leave
= NULL
;
67 * atk_misc_threads_enter:
68 * @misc: an AtkMisc instance for this application.
70 * Take the thread mutex for the GUI toolkit,
72 * (This method is implemented by the toolkit ATK implementation layer;
73 * for instance, for GTK+, GAIL implements this via GDK_THREADS_ENTER).
75 * Deprecated: Since 2.12.
81 atk_misc_threads_enter (AtkMisc
*misc
)
88 klass
= ATK_MISC_GET_CLASS (misc
);
90 if (klass
->threads_enter
)
92 klass
->threads_enter (misc
);
97 * atk_misc_threads_leave:
98 * @misc: an AtkMisc instance for this application.
100 * Release the thread mutex for the GUI toolkit,
101 * if one exists. This method, and atk_misc_threads_enter,
102 * are needed in some situations by threaded application code which
103 * services ATK requests, since fulfilling ATK requests often
104 * requires calling into the GUI toolkit. If a long-running or
105 * potentially blocking call takes place inside such a block, it should
106 * be bracketed by atk_misc_threads_leave/atk_misc_threads_enter calls.
107 * (This method is implemented by the toolkit ATK implementation layer;
108 * for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE).
110 * Deprecated: Since 2.12.
116 atk_misc_threads_leave (AtkMisc
*misc
)
123 klass
= ATK_MISC_GET_CLASS (misc
);
125 if (klass
->threads_leave
)
127 klass
->threads_leave (misc
);
131 AtkMisc
*atk_misc_instance
= NULL
;
134 * atk_misc_get_instance:
136 * Obtain the singleton instance of AtkMisc for this application.
140 * Deprecated: Since 2.12.
142 * Returns: The singleton instance of AtkMisc for this application.
146 atk_misc_get_instance (void)
148 return atk_misc_instance
;