/usr/share/pyshared/pyatspi/selection.py is in python-pyatspi 2.10.0+dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 | #Copyright (C) 2008 Codethink Ltd
#Copyright (C) 2010-2011 Novell, inc.
#This library is free software; you can redistribute it and/or
#modify it under the terms of the GNU Lesser General Public
#License version 2 as published by the Free Software Foundation.
#This program is distributed in the hope that it will be useful,
#but WITHOUT ANY WARRANTY; without even the implied warranty of
#MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
#GNU General Public License for more details.
#You should have received a copy of the GNU Lesser General Public License
#along with this program; if not, write to the Free Software
#Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
from gi.repository import Atspi
from pyatspi.utils import *
from pyatspi.interface import *
__all__ = [
"Selection",
]
#------------------------------------------------------------------------------
class Selection(interface):
"""
An interface which indicates that an object exposes a 'selection'
model, allowing the selection of one or more of its children.
Read-only Selection instances are possible, in which case the
interface is used to programmatically determine the selected-ness
of its children. A selected child has State::STATE_SELECTED,
and a child which may hypothetically be selected (though possibly
not programmatically selectable) has State::STATE_SELECTABLE.
"""
def clearSelection(self):
"""
Attempt to clear all selections (i.e. deselect all children)
of a Selection. Not all Selection implementations allow the removal
of all selections.
@return True if the selections were successfully cleared, False
otherwise.
"""
return Atspi.Text.clear_selection(self.obj)
def deselectChild(self, childIndex):
"""
Remove a child from the selected children list of a Selection,
if the child is currently selected.
@param : childIndex
a long integer (the zero offset index into the Accessible object's
list of children) indicating which child of the Selection is
to be selected.
@return True if the child was successfully selected, False otherwise.
"""
return Atspi.Selection.deselect_child(self.obj, childIndex)
def deselectSelectedChild(self, index):
"""
Remove a child to the selected children list of a Selection.
@param : selectedChildIndex
a long integer indicating which of the selected children of the
Selection is to be deselected. The index is a zero-offset index
into the 'selected child list', not a zero-offset index into
the list of all children of the Selection.
@return True if the child was successfully deselected, False
otherwise.
"""
return Atspi.Selection.deselect_selected_child(self.obj, index)
def getSelectedChild(self, index):
"""
Get the i-th selected Accessible child of a Selection.
@param : selectedChildIndex
a long integer indicating which of the selected children of an
object is being requested.
@return a pointer to a selected Accessible child object, specified
by selectedChildIndex.
"""
return Atspi.Selection.get_selected_child(self.obj, index)
def isChildSelected(self, index):
"""
Determine whether a particular child of an Selection implementor
is currently selected. Note that childIndex is the zero-offset
index into the standard Accessible container's list of children.
@param : childIndex
an index into the Selection's list of children.
@return True if the specified child is currently selected, False
otherwise.
"""
return Atspi.Selection.is_child_selected(self.obj, index)
def selectAll(self):
"""
Attempt to select all of the children of a Selection implementor.
Not all Selection implementors support this operation (for instance,
implementations which support only "single selection" do not
support this operation).
@return True if successful, False otherwise.
"""
return Atspi.Selection.select_all(self.obj)
def selectChild(self, index):
"""
Add a child to the selected children list of a Selection.
@param : childIndex
a long integer indicating which child of the Selection is to
be selected.
@return True if the child was successfully selected, False otherwise.
"""
return Atspi.Selection.select_child(self.obj, index)
def get_nSelectedChildren(self):
return Atspi.Selection.get_n_selected_children(self.obj)
_nSelectedChildrenDoc = \
"""
The number of children of a Selection implementor which are currently
selected.
"""
nSelectedChildren = property(fget=get_nSelectedChildren, doc=_nSelectedChildrenDoc)
#END----------------------------------------------------------------------------
|