QCheckBox Class
QCheckBox ウィジェットは、テキストラベル付きのチェックボックスを提供します。詳細...
ヘッダー | #include <QCheckBox> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
継承: | QAbstractButton |
プロパティ
- tristate : bool
パブリック関数
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() で設定できます。ショートカット・キーは、優先する文字の前にアンパサンドを付けることで指定できます。例えば
この例では、ショートカットは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)
与えられた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
[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
[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.