ColorDialog QML Type

ネイティブカラーダイアログ。もっと見る...

Import Statement: import Qt.labs.platform
Inherits:

Dialog

プロパティ

詳細な説明

ColorDialog型は、ネイティブプラットフォームのカラーダイアログのための QML APIを提供します。

カラーダイアログを表示するには、ColorDialogのインスタンスを作成し、必要なプロパティを設定し、open ()を呼び出します。currentColor プロパティは、ダイアログ内で現在選択されている色を決定するために使用することができます。color プロパティが更新されるのは、ダイアログを受け入れることによって最終的な選択が行われた後だけである。

MenuItem {
    text: "Color"
    onTriggered: colorDialog.open()
}

ColorDialog {
    id: colorDialog
    currentColor: document.color
}

MyDocument {
    id: document
    color: colorDialog.color
}

利用可能性

ネイティブプラットフォームカラーダイアログは、現在以下のプラットフォームで利用可能です:

  • iOS
  • Linux(GTK+プラットフォーム・テーマで動作している場合)
  • macOS

Qt Labs Platform モジュールは、利用可能なネイティブ実装がないプラットフォームでのフォールバックとしてQt Widgets を使用します。したがって、Qt Labs Platform モジュールの型を使用するアプリケーションは、QtWidgets にリンクし、QGuiApplication の代わりにQApplication を使用する必要があります。

QtWidgets ライブラリにリンクするには、qmake プロジェクトファイルに以下を追加します:

QT += widgets

main()QApplication のインスタンスを作成します:

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

注意: Qt.labs モジュールの型は、将来のバージョンでも互換性が保たれることを保証するものではありません。

プロパティ ドキュメント

color : color

このプロパティは、最終的に受け入れられる色を保持します。

currentColor プロパティとは異なり、color プロパティは、ユーザーがダイアログで色を選択している間は更新されず、最終的な選択が行われた後にのみ更新されます。つまり、ユーザーがOK をクリックして色を選択したときです。あるいは、accepted() シグナルを処理して、最終的な選択を取得することもできます。

currentColor およびaccepted()も参照してください


currentColor : color

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

color プロパティとは異なり、currentColor プロパティは、ユーザーがダイアログで色を選択している間、最終選択が行われる前であっても更新されます。

colorも参照してください


options : flags

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

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

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

利用可能なオプション

定数説明
ColorDialog.ShowAlphaChannelユーザーが色のアルファ成分を選択できるようにします。
ColorDialog.NoButtonsOKCancel ボタンを表示しない (「ライブダイアログ」に便利)。

© 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.