Current File : //usr/lib/python3/dist-packages/orca/scripts/toolkits/Qt/script_utilities.py
# Orca
#
# Copyright (C) 2023 Igalia, S.L.
#
# Author: Joanmarie Diggs <jdiggs@igalia.com>
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library 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
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the
# Free Software Foundation, Inc., Franklin Street, Fifth Floor,
# Boston MA 02110-1301 USA.
__id__ = "$Id$"
__version__ = "$Revision$"
__date__ = "$Date$"
__copyright__ = "Copyright (c) 2023 Igalia, S.L."
__license__ = "LGPL"
import orca.debug as debug
import orca.script_utilities as script_utilities
from orca.ax_object import AXObject
from orca.ax_utilities import AXUtilities
class Utilities(script_utilities.Utilities):
def __init__(self, script):
super().__init__(script)
def _isTopLevelObject(self, obj):
# This is needed because Qt apps might insert some junk (e.g. a filler) in
# between the window/frame/dialog and the application.
return AXUtilities.is_application(AXObject.get_parent(obj))
def topLevelObject(self, obj, useFallbackSearch=False):
# The fallback search is needed because sometimes we can ascend the accessibility
# tree all the way to the top; other times, we cannot get the parent, but can still
# get the children. The fallback search handles the latter scenario.
result = super().topLevelObject(obj, useFallbackSearch=True)
if result is not None and AXObject.get_role(result) not in self._topLevelRoles():
tokens = ["QT: Top level object", result, "lacks expected role."]
debug.printTokens(debug.LEVEL_INFO, tokens, True)
return result
def frameAndDialog(self, obj):
"""Returns the frame and (possibly) the dialog containing obj."""
frame, dialog = super().frameAndDialog(obj)
if frame or dialog:
return frame, dialog
tokens = ["QT: Could not find frame or dialog for", obj]
debug.printTokens(debug.LEVEL_INFO, tokens, True)
topLevel = self.topLevelObject(obj, True)
tokens = ["QT: Returning", topLevel, "as frame for", obj]
debug.printTokens(debug.LEVEL_INFO, tokens, True)
return topLevel, None
def hasMeaningfulToggleAction(self, obj):
"""Returns True if obj has a meaningful toggle action."""
# https://bugreports.qt.io/browse/QTBUG-116204
if AXUtilities.is_table_cell_or_header(obj):
tokens = ["QT: Ignoring toggle action on", obj, "."]
debug.printTokens(debug.LEVEL_INFO, tokens, True)
return False
return super().hasMeaningfulToggleAction(obj)
Mini Shell