class QAccessibleActionInterface#

QAccessibleActionInterface 类实现了接口中对可调用动作的支持。 更多...

继承自： QAccessibleWidget

概要#

虚函数#

静态函数#

备注

本文档可能包含自动从C++翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建工单的方式告知我们。

详细描述#

可访问对象应实现行为界面，如果它们支持用户交互。通常此类界面由也实现了QAccessibleInterface的类实现。

支持的行为应使用本类中提供的预定义行为，除非不符合预定义行为。在这种情况下，可以添加自定义行为。

在继承QAccessibleActionInterface时，您需要提供一个actionNames列表，这是发现可用行为的主要方式。行为名称永远不会本地化。为了向用户展示行为，有两个函数需要返回名称的本地化版本并给出行为的描述。对于预定义的行为名称，请使用localizedActionName()和localizedActionDescription()返回它们的本地化对应物。

通常，您应使用预定义的行为名称之一，除非描述不符合这些名称的行为。

行为名称

描述

toggleAction()

切换项（复选框、单选按钮、开关等）

decreaseAction()

减少可访问对象的值（例如，滑动框）

increaseAction()

增加可访问对象的值（例如，滑动框）

pressAction()

按下或点击或激活可访问对象（应相当于用鼠标点击对象）

setFocusAction()

将焦点设置到此可访问对象

showMenuAction()

显示上下文菜单，相当于右键单击

为了调用操作，使用行为名称调用doAction()。

大多数小工具将简单地实现pressAction()方法。这通常发生在小工具被点击、按下空格或类似操作激活时。

IAccessible2规范

abstract actionNames()#
返回类型：

字符串列表

返回由该可访问对象支持的动作列表。返回的动作应按首选顺序排列，即用户最可能想要触发的事件应首先返回，最不可能的事件应最后返回。

列表中仅包含可调用的动作，不会返回无效的动作或与无效UI控件关联的动作。

列表可以为空。

注意，此列表未本地化。若要获取本地化表示，请重新实现localizedActionName()和localizedActionDescription()

static decreaseAction()#
返回类型：

字符串

返回减少默认动作的名称。

abstract doAction(actionName)#
参数：

actionName – 字符串

调用由actionName指定的动作。注意，actionName是非本地化名称，由actionNames()返回。通常通过调用与用户交互相同的功能来实现此方法，例如点击对象。

另请参阅

actionNames()

static increaseAction()#
返回类型：

字符串

返回增加默认动作的名称。

摘要 keyBindingsForAction(actionName)#
参数：

actionName – 字符串

返回类型：

字符串列表

返回调用名为 actionName 的动作可用的键盘快捷方式列表。

这很重要，可以通过强调键盘来让用户了解通过键盘使用应用程序的替代方式。

另请参阅

actionNames()

localizedActionDescription(name)#
参数：

name – str

返回类型：

字符串

返回动作 actionName 的本地化动作描述。

当使用默认名称之一时，您可以在 QAccessibleActionInterface 中调用此函数以获取本地化字符串。

localizedActionName(name)#
参数：

name – str

返回类型：

字符串

返回 actionName 的本地化动作名称。

对于自定义动作，此函数必须被重新实现。当使用默认名称之一时，您可以在 QAccessibleActionInterface 中调用此函数以获取本地化字符串。

静态 nextPageAction()#
返回类型：

字符串

返回下一页默认动作的名称。

静态 pressAction()#
返回类型：

字符串

返回按下默认动作的名称。

静态 previousPageAction()#
返回类型：

字符串

返回上一页默认动作的名称。

静态 scrollDownAction()#
返回类型：

字符串

返回向下滚动默认动作的名称。

静态 scrollLeftAction()#
返回类型：

字符串

返回向左滚动默认动作的名称。

静态 scrollRightAction()#
返回类型：

字符串

返回向右滚动默认动作的名称。

静态 scrollUpAction()#
返回类型：

字符串

返回滚动至上一个项目的默认操作名称。

静态 setFocusAction()#
返回类型：

字符串

返回设置焦点默认操作名称。

静态 showMenuAction()#
返回类型：

字符串

返回显示菜单默认操作名称。

静态 toggleAction()#
返回类型：

字符串

返回切换默认操作名称。