projects
/
platform
/
upstream
/
atk.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Updated FSF's address
[platform/upstream/atk.git]
/
atk
/
atkutil.c
diff --git
a/atk/atkutil.c
b/atk/atkutil.c
old mode 100755
(executable)
new mode 100644
(file)
index
924d0a0
..
be4434f
--- a/
atk/atkutil.c
+++ b/
atk/atkutil.c
@@
-12,15
+12,24
@@
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* 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.
+ * License along with this library; if not, see <http://www.gnu.org/licenses/>.
*/
#include "atkutil.h"
#include "atkmarshal.c"
#include "config.h"
*/
#include "atkutil.h"
#include "atkmarshal.c"
#include "config.h"
+/**
+ * SECTION:atkutil
+ * @Short_description: A set of ATK utility functions for event and toolkit support.
+ * @Title:AtkUtil
+ *
+ * A set of ATK utility functions which are used to support event
+ * registration of various types, and obtaining the 'root' accessible
+ * of a process and information about the current ATK implementation
+ * and toolkit version.
+ */
+
static void atk_util_class_init (AtkUtilClass *klass);
static AtkObject *previous_focus_object = NULL;
static void atk_util_class_init (AtkUtilClass *klass);
static AtkObject *previous_focus_object = NULL;
@@
-87,6
+96,11
@@
struct _FocusTracker {
* This function should be called by an implementation of the
* ATK interface if any specific work needs to be done to enable
* focus tracking.
* This function should be called by an implementation of the
* ATK interface if any specific work needs to be done to enable
* focus tracking.
+ *
+ * Deprecated: This method is deprecated since ATK version
+ * 2.9.4. Focus tracking has been dropped as a feature to be
+ * implemented by ATK itself.
+ *
**/
void
atk_focus_tracker_init (AtkEventListenerInit init)
**/
void
atk_focus_tracker_init (AtkEventListenerInit init)
@@
-103,6
+117,11
@@
atk_focus_tracker_init (AtkEventListenerInit init)
* Adds the specified function to the list of functions to be called
* when an object receives focus.
*
* Adds the specified function to the list of functions to be called
* when an object receives focus.
*
+ * Deprecated: This method is deprecated since ATK version
+ * 2.9.4. Focus tracking has been dropped as a feature to be
+ * implemented by ATK itself. If you need focus tracking on your
+ * implementation, subscribe to the state-changed:focused signal.
+ *
* Returns: added focus tracker id, or 0 on failure.
**/
guint
* Returns: added focus tracker id, or 0 on failure.
**/
guint
@@
-138,6
+157,11
@@
atk_add_focus_tracker (AtkEventListener focus_tracker)
* atk_remove_focus_tracker:
* @tracker_id: the id of the focus tracker to remove
*
* atk_remove_focus_tracker:
* @tracker_id: the id of the focus tracker to remove
*
+ * Deprecated: This method is deprecated since ATK version
+ * 2.9.4. Focus tracking has been dropped as a feature to be
+ * implemented by ATK itself. If you need focus tracking on your
+ * implementation, subscribe to the state-changed:focused signal.
+ *
* Removes the specified focus tracker from the list of functions
* to be called when any object receives focus.
**/
* Removes the specified focus tracker from the list of functions
* to be called when any object receives focus.
**/
@@
-170,6
+194,11
@@
atk_remove_focus_tracker (guint tracker_id)
*
* Cause the focus tracker functions which have been specified to be
* executed for the object.
*
* Cause the focus tracker functions which have been specified to be
* executed for the object.
+ *
+ * Deprecated: This method is deprecated since ATK version
+ * 2.9.4. Focus tracking has been dropped as a feature to be
+ * implemented by ATK itself.
+ *
**/
void
atk_focus_tracker_notify (AtkObject *object)
**/
void
atk_focus_tracker_notify (AtkObject *object)
@@
-338,10
+367,12
@@
atk_util_real_remove_global_event_listener (guint remove_listener)
* ATK:AtkText:text-selection-changed
* ATK:AtkText:text-insert:system
*
* ATK:AtkText:text-selection-changed
* ATK:AtkText:text-insert:system
*
- * Toolkit implementor note: Atk provides a default implementation for
- * this virtual method, and that implementation should be enough for
- * most of the cases. You should have a really good reason to
- * reimplement this method.
+ * Toolkit implementor note: ATK provides a default implementation for
+ * this virtual method. ATK implementors are discouraged from
+ * reimplementing this method.
+ *
+ * Toolkit implementor note: this method is not intended to be used by
+ * ATK implementors but by ATK consumers.
*
* Returns: added event listener id, or 0 on failure.
**/
*
* Returns: added event listener id, or 0 on failure.
**/
@@
-372,10
+403,12
@@
atk_add_global_event_listener (GSignalEmissionHook listener,
* @listener_id is the value returned by #atk_add_global_event_listener
* when you registered that event listener.
*
* @listener_id is the value returned by #atk_add_global_event_listener
* when you registered that event listener.
*
- * Toolkit implementor note: Atk provides a default implementation for
- * this virtual method, and that implementation should be enough for
- * most of the cases. You should have a really good reason to
- * reimplement this method.
+ * Toolkit implementor note: ATK provides a default implementation for
+ * this virtual method. ATK implementors are discouraged from
+ * reimplementing this method.
+ *
+ * Toolkit implementor note: this method is not intended to be used by
+ * ATK implementors but by ATK consumers.
*
* Removes the specified event listener
**/
*
* Removes the specified event listener
**/