ColorDialog QML Type
ネイティブカラーダイアログ。もっと見る...
Import Statement: | import Qt.labs.platform |
Inherits: |
プロパティ
- color : color
- currentColor : color
- options : flags
詳細な説明
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 |
options : flags |
このプロパティは、ダイアログのルック&フィールに影響する様々なオプションを保持します。
デフォルトでは、すべてのオプションは無効になっています。
オプションはダイアログを表示する前に設定する必要があります。ダイアログが表示されている間にオプションを設定しても、ダイアログにすぐに効果があるとは限りません(オプションやプラットフォームによって異なります)。
利用可能なオプション
定数 | 説明 |
---|---|
ColorDialog.ShowAlphaChannel | ユーザーが色のアルファ成分を選択できるようにします。 |
ColorDialog.NoButtons | OK とCancel ボタンを表示しない (「ライブダイアログ」に便利)。 |
© 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.