Source code for traitsui.testing.tester.locator
# (C) Copyright 2004-2023 Enthought, Inc., Austin, TX
# All rights reserved.
#
# This software is provided without warranty under the terms of the BSD
# license included in LICENSE.txt and may be redistributed only under
# the conditions described in the aforementioned license. The license
# is also available online at http://www.enthought.com/licenses/BSD.txt
#
# Thanks for using Enthought open source!
""" This module defines objects for locating nested UI targets, to be
used with ``UIWrapper.locate``.
Implementations for these actions are expected to return a value which is
a UI target where further location resolution or user interaction can be
applied.
"""
[docs]class Cell:
""" A locator for locating a target uniquely specified by a row index and a
column index.
Attributes
----------
row : int
0-based index
column : int
0-based index
"""
def __init__(self, row, column):
self.row = row
self.column = column
[docs]class Index:
"""A locator for locating a target that is uniquely specified by a single
0-based index.
Attributes
----------
index : int
0-based index
"""
def __init__(self, index):
self.index = index
[docs]class TargetByName:
"""A locator for locating the next UI target using a name.
Attributes
----------
name : str
"""
def __init__(self, name):
self.name = name
[docs]class TargetById:
"""A locator for locating the next UI target using an id.
Attributes
----------
id : str
"""
def __init__(self, id):
self.id = id
[docs]class Slider:
"""A locator for locating a nested slider widget within a UI."""
pass
[docs]class Textbox:
"""A locator for locating a nested textbox widget within a UI."""
pass