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 がtrueの場合、アクショングループは無効になります。それ以外の場合は有効になります。

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