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

グループが排他的である場合、true を返します。

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()も参照してください 。