PySide6.QtGui.QAccessibleActionInterface¶

class QAccessibleActionInterface¶

QAccessibleActionInterface 类实现了对界面中可调用操作的支持。更多…

继承者： QAccessibleWidget

概要¶

虚拟方法¶

• def actionNames()

• def doAction()

• def keyBindingsForAction()

• def localizedActionDescription()

• def localizedActionName()

静态函数¶

• def decreaseAction()

• def increaseAction()

• def nextPageAction()

• def pressAction()

• def previousPageAction()

• def scrollDownAction()

• def scrollLeftAction()

• def scrollRightAction()

• def scrollUpAction()

• def setFocusAction()

• def showMenuAction()

• def toggleAction()

注意

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

详细描述¶

如果可访问对象支持用户交互，则应实现操作接口。通常，此接口由也实现QAccessibleInterface的类实现。

支持的操作应使用此类中提供的预定义操作，除非它们不适合预定义操作。在这种情况下，可以添加自定义操作。

当子类化 QAccessibleActionInterface 时，你需要提供一个 actionNames 列表，这是发现可用操作的主要方式。操作名称从不本地化。为了向用户展示操作，有两个函数需要返回名称的本地化版本并提供操作的描述。对于预定义的操作名称，使用 localizedActionName() 和 localizedActionDescription() 来返回它们的本地化对应项。

通常情况下，您应该使用预定义的操作名称之一，除非描述的操作不符合这些名称：

操作名称	描述
toggleAction()	切换项目（复选框、单选按钮、开关等）
decreaseAction()	减少可访问对象的值（例如：微调框）
increaseAction()	增加可访问对象的值（例如：微调框）
pressAction()	按下或点击或激活可访问的对象（应该对应于用鼠标点击对象）
setFocusAction()	将焦点设置到此可访问对象
showMenuAction()	显示上下文菜单，对应于右键点击

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

大多数小部件将简单地实现 pressAction()。这是当小部件通过点击、按下空格键或类似操作被激活时发生的情况。

IAccessible2 规范

abstract actionNames()¶

Return type:

字符串列表

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

该列表仅包含可以调用的操作。它不会返回禁用的操作，或与禁用的UI控件关联的操作。

列表可以为空。

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

另请参阅

doAction() localizedActionName() localizedActionDescription()

static decreaseAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

abstract doAction(actionName)¶

Parameters:

actionName – str

调用由actionName指定的操作。请注意，actionName是由actionNames()返回的非本地化名称。此函数通常通过调用与其他用户交互（例如点击对象）触发的相同函数来实现。

另请参阅

actionNames()

static increaseAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

abstract keyBindingsForAction(actionName)¶

Parameters:

actionName – str

Return type:

字符串列表

返回可用于调用名为actionName的操作的键盘快捷键列表。

重要的是通过强调键盘让用户学习使用应用程序的替代方法。

另请参阅

actionNames()

localizedActionDescription(name)¶

Parameters:

name – str

Return type:

字符串

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

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

另请参阅

actionNames() localizedActionName()

localizedActionName(name)¶

Parameters:

name – str

Return type:

字符串

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

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

另请参阅

actionNames() localizedActionDescription()

static nextPageAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

static pressAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

static previousPageAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

static scrollDownAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

static scrollLeftAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

static scrollRightAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

static scrollUpAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

static setFocusAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

static showMenuAction()¶

Return type:

字符串

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

另请参阅

actionNames() localizedActionName()

static toggleAction()¶

Return type:

字符串

返回切换默认操作的名称。

另请参阅

actionNames() localizedActionName()