ColorDialog QML Type

カラーダイアログ。もっと見る...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• options : flags
• selectedColor : color

詳細な説明

ColorDialog型はカラーダイアログのためのQML APIを提供します。

カラーダイアログを表示するには、ColorDialogのインスタンスを作成し、必要なプロパティを設定し、open （）を呼び出します。selectedColor プロパティは、ダイアログで最初に選択された色を決定するために使用することができます。

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

ColorDialog {
    id: colorDialog
    selectedColor: document.color
    onAccepted: document.color = selectedColor
}

MyDocument {
    id: document
}

利用可能性

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

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

Qt Quick ダイアログは、ネイティブな実装が利用できないプラットフォームでは、フォールバックとしてQt Quick の実装を使用します。

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

options : flags

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

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

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

利用可能なオプション

selectedColor : color

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

accepted() シグナルを処理して、最終的な選択色を取得することができます。ユーザがOpen をクリックして色を選択すると、accepted() シグナルのシグナルハンドラは selectedColor プロパティに問い合わせ、ユーザが選択した最終的な色を取得することができます。

accepted()も参照してください 。