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)
(until 6.9) void stateChanged(int 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 は視覚的な表現を提供しません。

下の画像は、排他的チェックボックスと非排他的チェックボックスの違いをさらに説明しています。

チェックボックスがチェックされたりクリアされたりするたびに、checkStateChanged ()というシグナルが発せられます。チェックボックスの状態が変わるたびにアクションをトリガーしたい場合は、このシグナルに接続します。isChecked() を使用すると、チェックボックスがチェックされているかどうかを問い合わせることができます。

QCheckBox は、通常の checked 状態と unchecked 状態に加えて、オプションで "no change" を示す 3 番目の状態を提供します。これは、チェックボックスのチェックもチェック解除もしないという選択肢をユーザーに与える必要がある場合に便利です。この第3の状態が必要な場合は、setTristate() で有効にし、checkState() で現在のトグル状態を問い合わせます。

QPushButton と同様に、チェックボックスにはテキストと、オプションで小さなアイコンが表示される。アイコンはsetIcon() で設定します。テキストは、コンストラクタまたはsetText() で設定できます。ショートカット・キーは、優先する文字の前にアンパサンドを付けることで指定できます。例えば

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

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

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

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

tristate : bool

このプロパティは、チェックボックスがトライステート・チェックボックスであるかどうかを保持する。

デフォルトは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)

与えられたparenttext でチェックボックスを構築します。

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

[signal, until 6.9] void QCheckBox::stateChanged(int state)

この関数はバージョン6.9で廃止予定です。

代わりにcheckStateChanged(Qt::CheckState) を使用してください。

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

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

© 2025 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.