ColorDialog QML Type

ネイティブのカラーダイアログ。詳細...

このタイプは Qt Labs Platform 6.9 以降、非推奨となっています。新しいコードでの使用は強くお勧めしません。

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• color : color
• currentColor : color
• options : flags

詳細説明

代わりにQtQuick.Dialogs ColorDialog を使用してください。

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();
}

「QtQuick.Dialogs::ColorDialog」も参照してください 。

プロパティのドキュメント

color : color

このプロパティには、最終的に受け入れられた色が格納されます。

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

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

currentColor : color

このプロパティには、ダイアログで現在選択されている色が格納されます。

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

「color」も参照してください 。

options : flags

このプロパティには、ダイアログの外観や動作に影響を与えるさまざまなオプションが格納されています。

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

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

利用可能なオプション：