atk.Selection the ATK interface implemented by container objects whose atk.Object children can be selected. Synopsis atk.Selection gobject.GInterface add_selection i clear_selection ref_selection i get_selection_count is_child_selected i remove_selection i select_all_selection atk.Selection Signal Prototypes "selection-changed" callback atkselection user_param1 ... Description atk.Selection should be implemented by UI components with children which are exposed by the ref_accessible_child() and get_n_accessible_children() methods, if the use of the parent UI component ordinarily involves selection of one or more of the objects corresponding to those atk.Object children - for example, selectable lists. Note that other types of "selection" (for instance text selection) are accomplished a other ATK interfaces - atk.Selection is limited to the selection/deselection of children. Methods atk.Selection.add_selection add_selection i i : an index specifying the child index. Returns : True if success, False otherwise. Adds the specified accessible child of the object to the object's selection. atk.Selection.clear_selection clear_selection Returns : True if success, False otherwise. Clears the selection in the object so that no children in the object are selected. atk.Selection.ref_selection ref_selection i i : an index specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child). Returns : an atk.Object representing the selected accessible , or None if the selection does not implement this interface. Gets a reference to the accessible object representing the specified selected child of the object. Note: callers should not rely on None or on a zero value for indication of whether the atk.Selection interface is implemented. atk.Selection.get_selection_count get_selection_count Returns : an integer representing the number of items selected, or 0 if the selection does not implement this interface. Gets the number of accessible children currently selected. Note: callers should not rely on None or on a zero value for indication of whether the atk.Selection interface is implemented. atk.Selection.is_child_selected is_child_selected i i : an index specifying the child index. Returns : True if the specified child is selected, or 0 if the selection does not implement this interface. Determines if the current child of this object is selected Note: callers should not rely on None or on a zero value for indication of whether the atk.Selection interface is implemented. atk.Selection.remove_selection remove_selection i i : an index specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child). Returns : True if success, False otherwise. Removes the specified child of the object from the object's selection. atk.Selection.select_all_selection select_all_selection Returns : True if success, False otherwise. Causes every child of the object to be selected if the object supports multiple selections. Signals The "selection-changed" atk.Selection Signal callback atkselection user_param1 ... atkselection : the object which received the signal. user_param1 : the first user parameter (if any) specified with the connect() method ... : additional user parameters (if any) The "selection-changed" signal is emitted by an object which implements atk.Selection interface when the selection changes.