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 ボタンを表示しない(「ライブダイアログ」に便利)。 |
©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
