Package AccessEngine :: Package AEAccAdapters :: Package ATSPI :: Module TableAdapter :: Class TableNavAdapter
[hide private]
[frames] | no frames]

Class TableNavAdapter

source code

??-168 --+
         |
        TableNavAdapter

Overrides DefaultNavAdapter to provide navigation over table cells as items. Expects the subject to be a AEPor. Does not walk headers. Those can be gotten and reported separately as context information.

Note that not all tables properly respond to requests for accessibles at (x,y) coordinates on the screen. Most tables seem to always return their first accessible (not first visible accessible) for the top left corner and last accessible (not last visible accessible) for the bottom right corner, but this depends on the application.

Adapts subject accessibles that provide the pyatspi.Accessibility.Accessible..ITable interface.

Instance Methods [hide private]
2-tuple of integer
_getVisibleItemExtents(self, only_visible)
Gets the item offsets of the first and last items in a table of cells.
source code
AEPor
getNextItem(self, only_visible=True)
Gets the next item relative to the one indicated by the AEPor providing this interface.
source code
AEPor
getPrevItem(self, only_visible=True)
Gets the previous item relative to the one indicated by the AEPor providing this interface.
source code
AEPor
getLastItem(self, only_visible=True)
Gets the last item relative to the one indicated by the AEPor providing this interface.
source code
AEPor
getFirstItem(self, only_visible=True)
Gets the first item relative to the one indicated by the AEPor providing this interface.
source code
 
getFirstAccChild(self)
Always raises LookupError.
source code
 
getLastAccChild(self)
Always raises LookupError.
source code
 
getChildAcc(self, index)
Always raises LookupError.
source code
Static Methods [hide private]
boolean
when(subject)
Tests if the given subject can be adapted by this class.
source code
Class Variables [hide private]
  provides = [IAccessibleNav, IItemNav]
Method Details [hide private]

when(subject)
Static Method

source code 
Tests if the given subject can be adapted by this class.
Parameters:
  • subject (AEPor) - AEPor containing an accessible to test
Returns: boolean
True when the subject meets the condition named in the docstring for this class, False otherwise

_getVisibleItemExtents(self, only_visible)

source code 
Gets the item offsets of the first and last items in a table of cells.
Parameters:
  • only_visible (boolean) - Only consider the first and last cells visible in the table (True) or the absolute first and last cells (False)?
Returns: 2-tuple of integer
First and last item offsets
Raises:
  • LookupError - When the first or last item or parent accessible is not available

getNextItem(self, only_visible=True)

source code 
Gets the next item relative to the one indicated by the AEPor providing this interface.
Parameters:
  • only_visible (boolean) - True when Item in the returned AEPor must be visible
Returns: AEPor
Point of regard to the next item in the same accessible
Raises:
  • IndexError - When there is no next item
  • LookupError - When lookup for the next item fails even though it may exist

getPrevItem(self, only_visible=True)

source code 
Gets the previous item relative to the one indicated by the AEPor providing this interface.
Parameters:
  • only_visible (boolean) - True when Item in the returned AEPor must be visible
Returns: AEPor
Point of regard to the previous item in the same accessible
Raises:
  • IndexError - When there is no previous item
  • LookupError - When lookup for the previous item fails even though it may exist

getLastItem(self, only_visible=True)

source code 
Gets the last item relative to the one indicated by the AEPor providing this interface.
Parameters:
  • only_visible (boolean) - True when Item in the returned AEPor must be visible
Returns: AEPor
Point of regard to the last item in the same accessible
Raises:
  • LookupError - When lookup for the last item fails even though it may exist

getFirstItem(self, only_visible=True)

source code 
Gets the first item relative to the one indicated by the AEPor providing this interface.
Parameters:
  • only_visible (boolean) - True when Item in the returned AEPor must be visible
Returns: AEPor
Point of regard to the last item in the same accessible
Raises:
  • LookupError - When lookup for the last item fails even though it may exist

getFirstAccChild(self)

source code 
Always raises LookupError. Tables have items but no children.
Raises:
  • LookupError - Always

getLastAccChild(self)

source code 
Always raises LookupError. Tables have items but no children.
Raises:
  • LookupError - Always

getChildAcc(self, index)

source code 
Always raises LookupError. Tables have items but no children.
Raises:
  • LookupError - Always