QColorDialog Class

QColorDialog クラスは、色を指定するためのダイアログ・ウィジェットを提供します。詳細...

Header: #include <QColorDialog>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: QDialog

パブリックタイプ

enum ColorDialogOption { ShowAlphaChannel, NoButtons, NoEyeDropperButton, DontUseNativeDialog }
flags ColorDialogOptions

プロパティ

パブリック関数

QColorDialog(QWidget *parent = nullptr)
QColorDialog(const QColor &initial, QWidget *parent = nullptr)
virtual ~QColorDialog()
QColor currentColor() const
void open(QObject *receiver, const char *member)
QColorDialog::ColorDialogOptions options() const
QColor selectedColor() const
void setCurrentColor(const QColor &color)
void setOption(QColorDialog::ColorDialogOption option, bool on = true)
void setOptions(QColorDialog::ColorDialogOptions options)
bool testOption(QColorDialog::ColorDialogOption option) const

再実装パブリック関数

virtual void setVisible(bool visible) override

シグナル

void colorSelected(const QColor &color)
void currentColorChanged(const QColor &color)

静的パブリックメンバ

QColor customColor(int index)
int customCount()
QColor getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions())
void setCustomColor(int index, QColor color)
void setStandardColor(int index, QColor color)
QColor standardColor(int index)

再実装された保護された関数

virtual void changeEvent(QEvent *e) override
virtual void done(int result) override

詳しい説明

カラーダイアログの機能は、ユーザーが色を選択できるようにすることです。例えば、ユーザーがブラシの色を設定できるようにするために、描画プログラムでこれを使用することができます。

静的関数はモーダルカラーダイアログを提供します。

静的関数getColor() はダイアログを表示し、ユーザに色を指定させます。この関数は、ユーザに透明度のある色を選択させるために使用することもできます:ShowAlphaChannel オプションを追加引数として渡してください。

ユーザはcustomCount() に異なるカスタム・カラーを保存することができます。カスタム・カラーはすべてのカラー・ダイアログで共有され、プログラムの実行中に記憶されます。カスタム・カラーを設定するにはsetCustomColor() を使用し、取得するにはcustomColor() を使用します。

Pick Screen Color "ボタンを押すと、カーソルがヘアクロスに変わり、スクリーン上の色がスキャンされる。ユーザーはマウスをクリックするか、Enterボタンをクリックすることで、1つを選ぶことができる。Escapeを押すと、このモードに入る前に最後に選択された色に戻ります。

標準ダイアログの例では、Qtの他の組み込みダイアログと同様にQColorDialogを使用する方法を示しています。

A color dialog in the Fusion widget style.

QColor,QFileDialog,QFontDialog,Standard Dialogs Exampleも参照してください

メンバ型ドキュメント

enum QColorDialog::ColorDialogOption
flags QColorDialog::ColorDialogOptions

この enum は、カラーダイアログのルック&フィールに影響するさまざまなオプションを指定します。

定数説明
QColorDialog::ShowAlphaChannel0x00000001ユーザーが色のアルファ成分を選択できるようにします。
QColorDialog::NoButtons0x00000002OKCancel ボタンを表示しない。(「ライブダイアログ」のために有用)
QColorDialog::NoEyeDropperButton0x00000008Eye Dropper ボタンを非表示にします。この値は Qt 6.6 で追加されました。
QColorDialog::DontUseNativeDialog0x00000004オペレーティング・システム・ネイティブのカラー・ダイアログの代わりに、Qtの標準のカラー・ダイアログを使用します。

ColorDialogOptions型はQFlags<ColorDialogOption>のtypedefです。これは、ColorDialogOption値のORの組み合わせを格納します。

options,setOption(),testOption(),windowModality()も参照のこと

プロパティの説明

currentColor : QColor

このプロパティは、ダイアログで現在選択されている色を保持します。

アクセス関数:

QColor currentColor() const
void setCurrentColor(const QColor &color)

ノーティファイアシグナル:

void currentColorChanged(const QColor &color)

options : ColorDialogOptions

このプロパティは、ダイアログのルック&フィールに影響する様々なオプションを保持します。

デフォルトでは、すべてのオプションは無効になっています。

オプションはダイアログを表示する前に設定する必要があります。ダイアログが表示されている間にオプションを設定しても、ダイアログに即座に反映されるとは限りません(オプションやプラットフォームによって異なります)。

アクセス関数:

QColorDialog::ColorDialogOptions options() const
void setOptions(QColorDialog::ColorDialogOptions options)

setOption() およびtestOption()も参照

メンバ関数ドキュメント

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

与えられたparent でカラーダイアログを構築します。

[explicit] QColorDialog::QColorDialog(const QColor &initial, QWidget *parent = nullptr)

与えられたparent と指定されたinitial 色でカラーダイアログを構築します。

[virtual noexcept] QColorDialog::~QColorDialog()

カラーダイアログを破棄します。

[override virtual protected] void QColorDialog::changeEvent(QEvent *e)

再実装します:QWidget::changeEvent(QEvent *event)。

[signal] void QColorDialog::colorSelected(const QColor &color)

このシグナルは、ユーザが使用する色を選択するためにOK をクリックした直後に発行されます。選択された色はcolor で指定されます。

colorおよびcurrentColorChanged()も参照してください

[signal] void QColorDialog::currentColorChanged(const QColor &color)

このシグナルは、ダイアログの現在の色が変更されるたびに発行されます。現在の色はcolor で指定されます。

注: currentColor プロパティに対するノーティファイアシグナル。

colorおよびcolorSelected()も参照して ください。

[static] QColor QColorDialog::customColor(int index)

指定されたindex のカスタムカラーをQColor の値として返します。

setCustomColor()も参照

[static] int QColorDialog::customCount()

QColorDialog でサポートされているカスタムカラーの数を返します。すべてのカラーダイアログは同じカスタムカラーを共有します。

[override virtual protected] void QColorDialog::done(int result)

再インプリメント:QDialog::done(int r)を参照してください。

ダイアログを閉じ、その結果コードをresult に設定します。 このダイアログがexec() で表示されている場合、 done() によってローカル・イベント・ループが終了し、exec() がresult を返します。

QDialog::done()も参照

[static] QColor QColorDialog::getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions())

指定されたウィンドウtitle (指定されていない場合は "Select Color")でモーダルカラーダイアログをポップアップし、ユーザーに色を選択させ、その色を返します。initialダイアログはparent の子ダイアログです。 ユーザがダイアログをキャンセルした場合、無効な色(QColor::isValid() を参照)を返します。

options 引数を指定すると、ダイアログをカスタマイズできます。

void QColorDialog::open(QObject *receiver, const char *member)

ダイアログを開き、そのcolorSelected() シグナルをreceivermember で指定されたスロットに接続します。

ダイアログが閉じられると、シグナルはスロットから切断されます。

QColor QColorDialog::selectedColor() const

ユーザーがOK または同等のボタンをクリックして選択した色を返します。

注意: この色は、currentColor プロパティが保持する色と同じとは限りません。なぜなら、ユーザーは最終的に使用する色を選択する前に、異なる色を選択することができるからです。

[static] void QColorDialog::setCustomColor(int index, QColor color)

index のカスタムカラーをQColor color の値に設定します。

注意: この関数はmacOSプラットフォームのネイティブカラーダイアログには適用されません。それでもこの機能が必要な場合は、QColorDialog::DontUseNativeDialog オプションを使用してください。

customColor()も参照

void QColorDialog::setOption(QColorDialog::ColorDialogOption option, bool on = true)

on が真の場合、与えられたoption を有効に設定する。そうでない場合、与えられたoption をクリアする。

options およびtestOption()も参照

[static] void QColorDialog::setStandardColor(int index, QColor color)

index の標準色をQColor color の値に設定する。

注意: この関数は、macOSプラットフォーム上のネイティブカラーダイアログには適用されません。それでもこの機能が必要な場合は、QColorDialog::DontUseNativeDialog オプションを使用してください。

standardColor()も参照してください

[override virtual] void QColorDialog::setVisible(bool visible)

再実装:QDialog::setVisible(bool visible).

ダイアログの可視性を変更します。visible が真の場合、ダイアログは表示され、そうでない場合は非表示になります。

[static] QColor QColorDialog::standardColor(int index)

与えられたindex の標準色をQColor の値として返します。

setStandardColor()も参照してください

bool QColorDialog::testOption(QColorDialog::ColorDialogOption option) const

与えられたoption が有効であればtrue を返し、そうでなければ false を返す。

options およびsetOption() も参照して ください。

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