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 |
- 継承メンバを含むすべてのメンバの一覧
- QColorDialog はStandard Dialogs の一部です。
パブリックタイプ
enum | ColorDialogOption { ShowAlphaChannel, NoButtons, NoEyeDropperButton, DontUseNativeDialog } |
flags | ColorDialogOptions |
プロパティ
- currentColor : QColor
- options : 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を使用する方法を示しています。
QColor,QFileDialog,QFontDialog,Standard Dialogs Exampleも参照してください 。
メンバ型ドキュメント
enum QColorDialog::ColorDialogOption
flags QColorDialog::ColorDialogOptions
この enum は、カラーダイアログのルック&フィールに影響するさまざまなオプションを指定します。
定数 | 値 | 説明 |
---|---|---|
QColorDialog::ShowAlphaChannel | 0x00000001 | ユーザーが色のアルファ成分を選択できるようにします。 |
QColorDialog::NoButtons | 0x00000002 | OK とCancel ボタンを表示しない。(「ライブダイアログ」のために有用) |
QColorDialog::NoEyeDropperButton | 0x00000008 | Eye Dropper ボタンを非表示にします。この値は Qt 6.6 で追加されました。 |
QColorDialog::DontUseNativeDialog | 0x00000004 | オペレーティング・システム・ネイティブのカラー・ダイアログの代わりに、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() シグナルをreceiver とmember で指定されたスロットに接続します。
ダイアログが閉じられると、シグナルはスロットから切断されます。
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 を返す。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。