diff options
author | Alejandro Piñeiro <apinheiro@igalia.com> | 2013-12-10 16:35:35 +0100 |
---|---|---|
committer | Alejandro Piñeiro <apinheiro@igalia.com> | 2013-12-11 12:34:45 +0100 |
commit | a65911af37955dd4192c18eea6dbb2b82cabfc17 (patch) | |
tree | 55618897aa5f594e4b7adb6b6461e6e648a37f36 /atk/atkobject.h | |
parent | 950d216d137f9312d07b2d99db06f79075963ae8 (diff) | |
download | atk-a65911af37955dd4192c18eea6dbb2b82cabfc17.tar.gz |
atkobject: improve documentation for AtkObject::property-change
https://bugzilla.gnome.org/show_bug.cgi?id=644747
Diffstat (limited to 'atk/atkobject.h')
-rwxr-xr-x | atk/atkobject.h | 17 |
1 files changed, 5 insertions, 12 deletions
diff --git a/atk/atkobject.h b/atk/atkobject.h index 781c317..f0cb898 100755 --- a/atk/atkobject.h +++ b/atk/atkobject.h @@ -420,20 +420,13 @@ typedef struct _AtkStateSet AtkStateSet; /** * AtkPropertyValues: - * @property_name: The name of the ATK property which is being presented or which has been changed. - * @old_value: The old property value, NULL; in some contexts this value is undefined (see note below). + * @property_name: The name of the ATK property which has changed. + * @old_value: NULL. This field is not used anymore. * @new_value: The new value of the named property. * - * Note: for most properties the old_value field of #AtkPropertyValues - * will not contain a valid value. - * - * Currently, the only property for which old_value is used is - * accessible-state; for instance if there is a focus state the - * property change handler will be called for the object which lost the focus - * with the old_value containing an #AtkState value corresponding to focused - * and the property change handler will be called for the object which - * received the focus with the new_value containing an #AtkState value - * corresponding to focused. + * Note: @old_value field of #AtkPropertyValues will not contain a + * valid value. This is a field defined with the purpose of contain + * the previous value of the property, but is not used anymore. * **/ struct _AtkPropertyValues |