* Boston, MA 02111-1307, USA.
*/
+#include "config.h"
+
#include "atkutil.h"
#include "atkmarshal.c"
-#include "config.h"
/**
* SECTION:atkutil
* 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.
+ * Deprecated: 2.9.4: Focus tracking has been dropped as a feature
+ * to be implemented by ATK itself.
*
**/
void
* 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.
+ * Deprecated: 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 #AtkObject::state-change "focused" signal.
*
* Returns: added focus tracker id, or 0 on failure.
**/
* 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.
+ * Deprecated: 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 #AtkObject::state-change "focused" signal.
*
* Removes the specified focus tracker from the list of functions
* to be called when any object receives focus.
* 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.
- *
+ * Deprecated: 2.9.4: Focus tracking has been dropped as a feature
+ * to be implemented by ATK itself. As #AtkObject::focus-event was
+ * deprecated in favor of a #AtkObject::state-change signal, in order
+ * to notify a focus change on your implementation, you can use
+ * atk_object_notify_state_change() instead.
**/
void
atk_focus_tracker_notify (AtkObject *object)
* Toolkit implementor note: this method is not intended to be used by
* ATK implementors but by ATK consumers.
*
+ * ATK consumers note: as this method adds a listener for a given ATK
+ * type, that type should be already registered on the GType system
+ * before calling this method. A simple way to do that is creating an
+ * instance of #AtkNoOpObject. This class implements all ATK
+ * interfaces, so creating the instance will register all ATK types as
+ * a collateral effect.
+ *
* Returns: added event listener id, or 0 on failure.
**/
guint