QActionGroup Class

メンバ関数ドキュメント

[explicit] QActionGroup::QActionGroup(QObject *parent)

parent オブジェクトのアクショングループを構築する。

アクショングループはデフォルトで排他的です。アクショングループを非排他的にするにはsetExclusive(false) を呼び出します。グループを排他的にするが、アクティブなアクションのチェックを外すことを許可するには、代わりにsetExclusionPolicy(QActionGroup::ExclusionPolicy::ExclusiveOptional) を呼び出します。

[virtual noexcept] QActionGroup::~QActionGroup()

アクショングループを破壊する。

QList<QAction *> QActionGroup::actions() const

このグループのアクションのリストを返します。空でもかまいません。

QAction *QActionGroup::addAction(QAction *action)

action をこのグループに追加し、それを返す。

通常、アクションをグループに追加するには、グループを親としてアクションを作成します。

QAction::setActionGroup()も参照してください 。

QAction *QActionGroup::addAction(const QString &text)

text を持つアクションを作成し、返します。新しく作成されたアクションは、このアクショングループの子になります。

通常、アクションはグループを親として作成することでグループに追加されるので、この関数は通常使用されません。

QAction::setActionGroup()も参照してください 。

QAction *QActionGroup::addAction(const QIcon &icon, const QString &text)

text 、icon を持つアクションを作成し、返します。 新しく作成されたアクションは、このアクショングループの子になります。

通常、アクションをグループに追加するには、グループを親としてアクションを作成します。

QAction::setActionGroup()も参照してください 。

QAction *QActionGroup::checkedAction() const

グループ内で現在チェックされているアクションを返します。チェックされていない場合はnullptr を返します。

[signal] void QActionGroup::hovered(QAction *action)

このシグナルは、アクショングループ内の指定されたaction 、ユーザーによってハイライトされたときに発せられます。例えば、ユーザーがメニューオプションやツールバーボタンの上でカーソルを一時停止したときや、アクションのショートカットキーの組み合わせを押したときなどに発せられます。

QAction::activate()も参照してください 。

bool QActionGroup::isExclusive() const

グループが排他的であれば真を返す

ExclusionPolicy が Exclusive または ExclusionOptional の場合、グループは排他的です。

void QActionGroup::removeAction(QAction *action)

このグループからaction を削除する。アクションは結果として親を持ちません。

QAction::setActionGroup()も参照してください 。

[slot] void QActionGroup::setDisabled(bool b)

これはenabled プロパティの便宜関数であり、シグナルとスロットの接続に便利である。b が真の場合、アクショングループは無効になり、そうでない場合は有効になります。

[slot] void QActionGroup::setExclusive(bool b)

グループ除外チェックを有効または無効にする

これは便宜的なメソッドで、b が true の場合はsetExclusionPolicy(ExclusionPolicy::Exclusive) を、そうでない場合はsetExclusionPolicy(QActionGroup::ExclusionPolicy::None) を呼び出します。

isExclusive() およびQActionGroup::exclusionPolicyも参照 。

[signal] void QActionGroup::triggered(QAction *action)

action 例えば、ユーザーがメニューオプションやツールバーボタンをクリックしたり、アクションのショートカットキーの組み合わせを押したりしたときなどです。

コマンドアクションの場合は、このシグナルに接続します。

QAction::activate()も参照してください 。