[atk] Fix some unclear language regarding ATK_STATE_ACTIVE



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]