QRadioButton Class

QRadioButtonウィジェットは、テキストラベル付きのラジオボタンを提供します。詳細...

Header: #include <QRadioButton>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: QAbstractButton

パブリック関数

QRadioButton(QWidget *parent = nullptr)
QRadioButton(const QString &text, QWidget *parent = nullptr)
virtual ~QRadioButton()

再実装パブリック関数

virtual QSize minimumSizeHint() const override
virtual QSize sizeHint() const override

保護された関数

virtual void initStyleOption(QStyleOptionButton *option) const

再実装された保護された関数

virtual bool event(QEvent *e) override
virtual bool hitButton(const QPoint &pos) const override
virtual void mouseMoveEvent(QMouseEvent *e) override
virtual void paintEvent(QPaintEvent *) override

詳細説明

QRadioButtonは、オン(チェック)またはオフ(チェックなし)に切り替えられるオプションボタンです。ラジオボタンは通常、ユーザーに「多くの選択肢のうちの1つ」を提示します。ラジオボタンのグループでは、一度に1つのラジオボタンのみをチェックすることができます。ユーザーが別のボタンを選択すると、前に選択されたボタンはオフになります。

ラジオボタンはデフォルトでautoExclusiveです。オートエクスクルーシブが有効な場合、同じ親ウィジェットに属するラジオボタンは、同じエクスクルーシブボタングループに属しているかのように動作します。同じ親ウィジェットに属するラジオボタンに複数の排他的ボタングループが必要な場合は、QButtonGroup

ボタンがオンまたはオフに切り替わるたびに、ボタンはtoggled() シグナルを発信します。ボタンの状態が変わるたびにアクションをトリガーしたい場合は、このシグナルに接続してください。特定のボタンが選択されているかどうかを調べるには、isChecked() を使用します。

QPushButton のように、ラジオ・ボタンはテキストと、オプションで小さなアイコンを表示します。アイコンはsetIcon() で設定します。テキストは、コンストラクタまたはsetText() で設定できます。ショートカット・キーは、テキスト中の優先文字の前にアンパサンドを置くことで指定できます。例えば

QRadioButton *button = new QRadioButton("Search from the &cursor", this);

この例では、ショートカットはAlt+cです。詳細はQShortcut のドキュメントを参照してください。実際のアンパサンドを表示するには、'&&' を使用する。

重要な継承メンバ:text()、setText()、text()、setDown()、isDown()、autoRepeat()、group()、setAutoRepeat()、toggle()、pressed()、released()、clicked()、toggled()。

QPushButtonQToolButtonQCheckBoxも参照のこと

メンバ関数ドキュメント

[explicit] QRadioButton::QRadioButton(QWidget *parent = nullptr)

与えられたparent を持つ、テキストも pixmap もないラジオボタンを構築します。

parent 引数はQAbstractButton コンストラクタに渡されます。

[explicit] QRadioButton::QRadioButton(const QString &text, QWidget *parent = nullptr)

与えられたparenttext 文字列でラジオボタンを構築します。

parent 引数はQAbstractButton コンストラクタに渡されます。

[virtual noexcept] QRadioButton::~QRadioButton()

デストラクタ。

[override virtual protected] bool QRadioButton::event(QEvent *e)

再インプリメント:QAbstractButton::event(QEvent *e)。

[override virtual protected] bool QRadioButton::hitButton(const QPoint &pos) const

再リンプルメント:QAbstractButton::hitButton(const QPoint &pos) const.

[virtual protected] void QRadioButton::initStyleOption(QStyleOptionButton *option) const

このQRadioButton の値でoption を初期化します。このメソッドは、サブクラスがQStyleOptionButton を必要とするが、すべての情報を自分で入力したくない場合に便利です。

QStyleOption::initFrom()も参照してください

[override virtual] QSize QRadioButton::minimumSizeHint() const

プロパティのアクセス関数を再インプリメントします:QWidget::minimumSizeHint

[override virtual protected] void QRadioButton::mouseMoveEvent(QMouseEvent *e)

再実装:QAbstractButton::mouseMoveEvent(QMouseEvent *e)。

[override virtual protected] void QRadioButton::paintEvent(QPaintEvent *)

再リプリメント:QAbstractButton::paintEvent(QPaintEvent *e)。

[override virtual] QSize QRadioButton::sizeHint() const

プロパティのアクセス関数を再実装:QWidget::sizeHint.

©2024 The Qt Company Ltd. 本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。