[atk] Fix some unclear language regarding ATK_STATE_ACTIVE
- From: Joanmarie Diggs <joanied src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [atk] Fix some unclear language regarding ATK_STATE_ACTIVE
- Date: Thu, 13 Nov 2014 12:14:10 +0000 (UTC)
commit cb699320cf90c04d267d9296410f949ddc9d893a
Author: Joanmarie Diggs <jdiggs igalia com>
Date: Wed Nov 12 21:50:40 2014 -0500
Fix some unclear language regarding ATK_STATE_ACTIVE
https://bugzilla.gnome.org/show_bug.cgi?id=740044
atk/atkstate.h | 2 +-
1 files changed, 1 insertions(+), 1 deletions(-)
---
diff --git a/atk/atkstate.h b/atk/atkstate.h
index 6403b02..180fb89 100755
--- a/atk/atkstate.h
+++ b/atk/atkstate.h
@@ -32,7 +32,7 @@ G_BEGIN_DECLS
/**
*AtkStateType:
* ATK_STATE_INVALID: Indicates an invalid state - probably an error condition.
- * ATK_STATE_ACTIVE: Indicates a window is currently the active window, or is an active subelement within a
container or table
+ * ATK_STATE_ACTIVE: Indicates a window is currently the active window, or an object is the active
subelement within a container or table. ATK_STATE_ACTIVE should not be used for objects which have
ATK_STATE_FOCUSABLE or ATK_STATE_SELECTABLE: Those objects should use ATK_STATE_FOCUSED and
ATK_STATE_SELECTED respectively. ATK_STATE_ACTIVE is a means to indicate that an object which is not
focusable and not selectable is the currently-active item within its parent container.
* ATK_STATE_ARMED: Indicates that the object is 'armed', i.e. will be activated by if a pointer
button-release event occurs within its bounds. Buttons often enter this state when a pointer click occurs
within their bounds, as a precursor to activation.
* ATK_STATE_BUSY: Indicates the current object is busy, i.e. onscreen representation is in the process of
changing, or the object is temporarily unavailable for interaction due to activity already in progress. This
state may be used by implementors of Document to indicate that content loading is underway. It also may
indicate other 'pending' conditions; clients may wish to interrogate this object when the ATK_STATE_BUSY flag
is removed.
* ATK_STATE_CHECKED: Indicates this object is currently checked, for instance a checkbox is 'non-empty'.
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]