QCheckBox Class

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

Header: #include <QCheckBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: 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 のドキュメントを参照してください。実際のアンパサンドを表示するには、「&&」を使用する。

重要な継承関数:text(),setText(),text(), pixmap(), setPixmap(), accel(), setAccel(), isToggleButton(),setDown(),isDown(), isOn(),checkState(),autoRepeat(), isExclusiveToggle(),group(),setAutoRepeat(),toggle(),pressed(),released(),clicked(),toggled(),checkState(),checkStateChanged()。

QAbstractButton およびQRadioButtonも参照のこと

プロパティ Documentation

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

再リンプルメント: (QEvent *e):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 *)

Reimplements: (QMouseEvent *e):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

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