|
Home · All Classes · Modules · QSS HELP · QSS 案例 · VER007 HOME |
QAction类负责提供可插入小部件抽象的用户界面操作。More...
继承QObject。
通过继承QWidgetAction。
QAction类负责提供可插入小部件抽象的用户界面操作。
在实际应用中很多常见的命令可以通过菜单，工具栏按钮和键盘快捷键来调用。由于用户期望要以相同的方式执行的每个命令，而不管所使用的用户界面，它表示每个命令作为一个非常有用action。
操作可以被添加到菜单和工具栏，并且会自动使它们保持同步。例如，在一个文字处理器，如果用户按下一个大胆的工具栏按钮，粗体菜单项将自动进行检查。
动作可以被创建为独立的对象，但它们也可以菜单的施工过程中产生;的QMenu类包含用于创建适合用作菜单项行动方便的功能。
一个的QAction可能包含图标，菜单文本，快捷键，状态文字， “这是什么？ ”文本和工具提示。大多数这些可以在构造函数中设置。它们也可以独立地设置setIcon（ ）setText（ ）setIconText（ ）setShortcut（ ）setStatusTip（ ）setWhatsThis（）和setToolTip（ ） 。为菜单项，可以设置一个单独的字体与setFont（ ） 。
操作使用添加小工具QWidget.addAction（）或QGraphicsWidget.addAction（ ） 。请注意，一个动作必须被添加到窗口小部件可以被使用之前，这也是真实的，当快捷方式应该是全局的（也就是Qt.ApplicationShortcut如Qt.ShortcutContext） 。
一次的QAction已创建它应该被添加到相关的菜单和工具栏上，然后连接到将执行的动作的插槽。例如：
openAct = new QAction(QIcon(":/images/open.png"), tr("&Open..."), this);
openAct->setShortcuts(QKeySequence.Open);
openAct->setStatusTip(tr("Open an existing file"));
connect(openAct, SIGNAL(triggered()), this, SLOT(open()));
fileMenu->addAction(openAct);
fileToolBar->addAction(openAct);
我们建议的行动被创建为使用它们。在大多数情况下，操作窗口的孩子们将应用程序的主窗口的儿童。
该枚举类型是调用时使用QAction.activate（ ）
| Constant | Value | Description |
|---|---|---|
| QAction.Trigger | 0 | 这将导致QAction.triggered（）信号被发射。 |
| QAction.Hover | 1 | 这将导致QAction.hovered（）信号被发射。 |
这个枚举变量描述了如何一个动作应该被移动到应用程序菜单上的Mac OS X。
| Constant | Value | Description |
|---|---|---|
| QAction.NoRole | 0 | 这个动作不应该被放到应用程序菜单 |
| QAction.TextHeuristicRole | 1 | 这个动作应该在应用程序菜单的基础上采取行动的文本中所描述的放QMenuBar文档。 |
| QAction.ApplicationSpecificRole | 2 | 这个动作应该被放置在应用程序菜单中有一个特定的应用程序角色 |
| QAction.AboutQtRole | 3 | 这个动作匹配处理“关于Qt ”菜单项。 |
| QAction.AboutRole | 4 | 这个动作应该放在哪里“关于”菜单项，在应用程序菜单。菜单项的文本将被设置为“关于\u003capplication NAME\u003e ” 。该应用程序的名称是从牵强Info.plist在应用程序的包文件（见Deploying an Application on Mac OS X） 。 |
| QAction.PreferencesRole | 5 | 这个动作应该放在那里的“首选项... ”菜单项，在应用程序菜单。 |
| QAction.QuitRole | 6 | 这个动作应该放在哪里Quit菜单项是在应用程序菜单。 |
设置此值只对那些在菜单栏，而不是那些菜单的子菜单的直接菜单项的效果。例如，如果你有文件菜单中的菜单栏和文件菜单中有一个子菜单，设置MenuRole在该子菜单中的操作没有任何效果。他们将永远不会被移动。
这个枚举变量定义为在用户界面操作的优先事项。
| Constant | Value | Description |
|---|---|---|
| QAction.LowPriority | 0 | 该操作不应该被优先在用户界面中。 |
| QAction.NormalPriority | 128 | |
| QAction.HighPriority | 256 | 该行动应优先在用户界面。 |
这个枚举被引入或修改的Qt 4.6 。
See also priority。
这个枚举说明如何动作应放置在软键栏。目前，该枚举只有在Symbian平台上的效果。
| Constant | Value | Description |
|---|---|---|
| QAction.NoSoftKey | 0 | 此操作不应该被用来作为一个软键 |
| QAction.PositiveSoftKey | 1 | 这个动作是用来描述一个软键以积极的还是非破坏性的作用，如OK，选择或选项。 |
| QAction.NegativeSoftKey | 2 | 这个动作是用来描述一个软安永具有负的或破坏性的角色作用，如取消，丢弃，或关闭。 |
| QAction.SelectSoftKey | 3 | 这个动作是用来描述用于选择应用程序中的特定项目或插件的作用。 |
与定义的功能键角色的动作才可见在软键栏时，包含动作的部件具有焦点。如果没有小工具目前拥有焦点时，软键框架将向上遍历父控件层次结构查找包含软键操作的部件。
这个枚举被引入或修改的Qt 4.6 。
该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。
构造一个行动parent。如果parent是一个行动小组的行动将被自动插入到组。
该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。
构造一个动作与一些text和parent。如果parent是一个行动小组的行动将被自动插入到组。
该操作使用的一个简化版本text（例如：“和菜单选项... ”变成“菜单选项” ）作为描述性文本工具按钮。您可以通过设置特定的描述与复盖此setText（ ） 。同样的文本将被用于工具提示除非您指定使用不同的文字setToolTip（ ） 。
该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。
构造一个动作与icon有的text和parent。如果parent是一个行动小组的行动将被自动插入到组。
该操作使用的一个简化版本text（例如：“和菜单选项... ”变成“菜单选项” ）作为描述性文本工具按钮。您可以通过设置特定的描述与复盖此setText（ ） 。同样的文本将被用于工具提示除非您指定使用不同的文字setToolTip（ ） 。
返回该行动小组的这一行动。如果不采取行动组管理这个行动，那么将返回0 。
See also QActionGroup和QAction.setActionGroup（ ） 。
发送相关信号ActionEvent event。
根据动作的部件使用这个API使QAction以发射信号，以及发射自己。
返回部件此操作已被添加到列表。
此功能被引入Qt的4.5 。
See also QWidget.addAction（）和associatedWidgets（ ） 。
返回部件此操作已被添加到列表。
这个函数中引入了Qt 4.2中。
See also QWidget.addAction（）和associatedGraphicsWidgets（ ） 。
返回用户数据作为在QAction.setData设置。
See also setData（ ） 。
从重新实现QObject.event（ ） 。
这种方法也是一个Qt槽与C + +的签名void hover()。
这是一个方便的插槽调用激活（哈弗） 。
返回True如果这个动作是一个分离器的动作，否则返回False 。
See also QAction.setSeparator（ ） 。
返回包含由这个动作菜单。包含菜单操作，可用于创建带有子菜单的菜单项，或插入到工具栏来创建弹出式菜单的按钮。
See also setMenu（）和QMenu.addAction（ ） 。
返回父控件。
设置此行动组group。该动作将被自动添加到行动组的列表。
组内的行动将是相互排斥的。
See also QActionGroup和QAction.actionGroup（ ） 。
这种方法也是一个Qt槽与C + +的签名void setChecked(bool)。
该行动的内部数据设置为给定userData。
See also data（ ） 。
这种方法也是一个Qt槽与C + +的签名void setDisabled(bool)。
这是一个方便的功能为enabled财产，那是非常有用的信号 - 槽连接。如果b是真实的动作被禁止，否则将被启用。
这种方法也是一个Qt槽与C + +的签名void setEnabled(bool)。
设置包含在这个动作菜单到指定的menu。
See also menu（ ） 。
If b是真的，那么这个动作将被视为分隔符。
如何隔板被表示取决于它被插入到插件。在大多数情况下文本，子菜单，图标将被忽略分隔符的行为。
See also QAction.isSeparator（ ） 。
Sets shortcuts作为触发动作的快捷键列表。列表中的第一个元素是主要的捷径。
这个函数中引入了Qt 4.2中。
See also shortcuts（）和shortcut。
设置快捷方式的基础上，一个平台相关的清单key。调用此函数的结果将取决于当前运行的平台上。请注意，一个以上的快捷方式可通过此操作分配。如果只有主快捷方式是必需的，使用setShortcut代替。
这个函数中引入了Qt 4.2中。
See also QKeySequence.keyBindings（ ） 。
这种方法也是一个Qt槽与C + +的签名void setVisible(bool)。
返回快捷键的列表，与主快捷键为列表的第一个元素。
这个函数中引入了Qt 4.2中。
See also setShortcuts（ ） 。
更新了相关的状态栏widget通过发送一个指定QStatusTipEvent它的父控件。如果返回的事件被送往True，否则返回False 。
如果指定的一个空小部件，则该事件被发送到该操作的父代。
See also statusTip。
这种方法也是一个Qt槽与C + +的签名void toggle()。
这是一个方便的功能为checked属性。连接到它的选中状态更改为相反的状态。
这种方法也是一个Qt槽与C + +的签名void trigger()。
这是一个方便的插槽调用激活（触发） 。
这是该信号的默认超载。
这个信号被发射时的动作已经改变。如果你只关心在一个给定的窗口小部件的动作，你可以观察QWidget.actionEvent（ ）发送与QEvent.ActionChanged。
See also QWidget.actionEvent（ ） 。
这是该信号的默认超载。
这个信号被发射时的动作是由用户突出显示的，例如，当用户暂停使用光标移到菜单选项，工具栏按钮，或按下一个操作的快捷键组合。
See also QAction.activate（ ） 。
这是该信号的默认超载。
这个信号被发射每当一个辨认的作用改变其isChecked（ ）状态。这可以是用户交互的结果，或者是因为setChecked（ ）被调用。
checked是如果动作被选中真的，还是假的，如果动作是听之任之。
See also QAction.activate（ ）QAction.triggered（）和checked。
这是该信号的默认超载。
这个信号被发射时的动作是由用户激活的，例如，当用户点击一个菜单选项，工具栏按钮，或按下一个操作的快捷键组合，或当trigger（ ）被调用。值得注意的是，它是not当发射setChecked（）或toggle（）被调用。
如果动作是可复，checked是如果动作被选中真的，还是假的，如果动作是听之任之。
See also QAction.activate（ ）QAction.toggled（）和checked。
| PyQt 4.10.3 for X11 | Copyright © Riverbank Computing Ltd and Nokia 2012 | Qt 4.8.5 |