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 |
プロパティ
- 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 のドキュメントを参照してください。実際のアンパサンドを表示するには、「&&」を使用する。
重要な継承関数: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)
指定された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
再リンプルメント: (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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。