ColorDialog QML Type
色選択ダイアログ。詳細...
| Import Statement: | import QtQuick.Dialogs |
| Since: | Qt 6.4 |
| Inherits: |
プロパティ
- 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 Dialogsは、ネイティブの実装が利用できないプラットフォームでは、フォールバックとしてQt Quick の実装を使用します。
プロパティのドキュメント
options : flags
このプロパティには、ダイアログの外観や動作に影響を与えるさまざまなオプションが設定されています。
デフォルトでは、すべてのオプションは無効になっています。
オプションは、ダイアログを表示する前に設定する必要があります。ダイアログが表示されている状態で設定しても、その変更がダイアログに即座に反映されるとは限りません(オプションやプラットフォームによって異なります)。
利用可能なオプション:
| 定数 | 説明 |
|---|---|
ColorDialog.ShowAlphaChannel | アルファ値用のスライダーと追加の入力フィールドを表示します。 |
ColorDialog.NoButtons | 「Open 」および「Cancel 」ボタンを表示しません(「ライブダイアログ」に有用です)。 |
ColorDialog.NoEyeDropperButton | 「Eye Dropper 」ボタンを表示しません。この値は Qt 6.6 で追加されました。 |
ColorDialog.DontUseNativeDialog | ダイアログに、ネイティブではない Quick 実装の使用を強制します。 |
selectedColor : color
このプロパティには、ダイアログで現在選択されている色が格納されます。
accepted() シグナルを処理することで、最終的に選択された色を取得できます。ユーザーが「Open 」をクリックして色を受け入れた場合、accepted() シグナルのシグナルハンドラは selectedColor プロパティを照会することで、ユーザーが最終的に選択した色を取得できます。
accepted()も参照してください 。
© 2026 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.