このページでは

QCheckBox Class

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

ヘッダー: #include <QCheckBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
継承元: QAbstractButton

プロパティ

パブリック関数

QCheckBox(QWidget *parent = nullptr)
QCheckBox(const QString &text, QWidget *parent = nullptr)
virtual ~QCheckBox()
Qt::CheckState checkState() const
bool isTristate() const
void setCheckState(Qt::CheckState state)
void setTristate(bool y = true)

再実装されたパブリック関数

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

シグナル

(since 6.7) void checkStateChanged(Qt::CheckState state)

保護された関数

virtual void initStyleOption(QStyleOptionButton *option) const

再実装されたプロテクトされた関数

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

詳細な説明

保存オプションのチェックボックス

QCheckBox は、オン(チェックあり)またはオフ(チェックなし)に切り替えることができるオプションボタンです。 チェックボックスは通常、他の機能に影響を与えることなく有効または無効にできるアプリケーションの機能を表すために使用されます。さまざまな種類の動作を実装することができます。たとえば、QButtonGroup を使用すると、チェックボタンを論理的にグループ化して、排他的なチェックボックスを実現できます。ただし、QButtonGroup は視覚的な表現を提供しません。

以下の画像は、排他チェックボックスと非排他チェックボックスの違いをさらに詳しく示しています。

1つのオプションのみを選択できるようにするチェックボックスグループ複数の選択肢にチェックを入れることができるチェックボックスグループ

チェックボックスがオンまたはオフになるたびに、checkStateChanged() シグナルが発信されます。チェックボックスの状態が変更されるたびにアクションをトリガーしたい場合は、このシグナルに接続してください。isChecked() を使用すると、チェックボックスがオンになっているかどうかを照会できます。

通常の「チェック済み」および「チェックなし」の状態に加え、QCheckBox にはオプションで「変更なし」を示す 3 番目の状態が用意されています。これは、ユーザーにチェックボックスのチェックも解除もしないという選択肢を提供する必要がある場合に役立ちます。 この3番目の状態が必要な場合は、setTristate() で有効にし、checkState() を使用して現在のトグル状態を照会してください。

QPushButton と同様に、チェックボックスにはテキストが表示され、必要に応じて小さなアイコンも表示されます。アイコンはsetIcon()で設定します。テキストはコンストラクタ内、またはsetText()で設定できます。ショートカットキーは、指定したい文字の前にアンパサンドを付けることで指定できます。例:

QCheckBox *checkbox = new QCheckBox("C&ase sensitive", this);

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

QAbstractButton およびQRadioButtonも参照してください 。

プロパティのドキュメント

tristate : bool

このプロパティは、チェックボックスが3状態のチェックボックスであるかどうかを指定します

デフォルトは false です。つまり、チェックボックスには 2 つの状態しかありません。

アクセス関数:

bool isTristate() const
void setTristate(bool y = true)

メンバ関数のドキュメント

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

指定されたparent を使用してチェックボックスを作成しますが、テキストは設定されません。

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

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

指定されたparent およびtext を使用して、チェックボックスを作成します。

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

[virtual noexcept] QCheckBox::~QCheckBox()

デストラクタ。

Qt::CheckState QCheckBox::checkState() const

チェックボックスのチェック状態を返します。トリステート機能が必要ない場合は、ブール値を返すQAbstractButton::isChecked() を使用することもできます。

setCheckState() およびQt::CheckStateも参照してください 。

[signal, since 6.7] void QCheckBox::checkStateChanged(Qt::CheckState state)

このシグナルは、チェックボックスの状態が変更されるたびに、つまりユーザーがチェックを入れたり外したりするたびに発生します。

state には、チェックボックスの新しいQt::CheckState が含まれます。

この関数は Qt 6.7 で導入されました。

[override virtual protected] void QCheckBox::checkStateSet()

QAbstractButton::checkStateSet() を再実装します。

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

QAbstractButton::event(QEvent *e) を再実装します。

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

QAbstractButton::hitButton (const QPoint &pos)const を再実装しています。

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

このQCheckBox の値を用いて、option を初期化します。このメソッドは、QStyleOptionButton が必要であるものの、すべての情報を自ら設定したくないサブクラスにとって便利です。

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

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

プロパティ「QWidget::minimumSizeHint 」のアクセス関数を再実装します。

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

QAbstractButton::mouseMoveEvent(QMouseEvent *e) を再実装します。

[override virtual protected] void QCheckBox::nextCheckState()

QAbstractButton::nextCheckState() を再実装します。

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

QAbstractButton::paintEvent(QPaintEvent *e) を再実装します。

void QCheckBox::setCheckState(Qt::CheckState state)

チェックボックスのチェック状態をstate に設定します。トリステート機能が必要ない場合は、ブール値を引数とするQAbstractButton::setChecked()を使用することもできます。

checkState() およびQt::CheckStateも参照してください 。

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

プロパティ「QWidget::sizeHint 」のアクセス関数を再実装します。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.