ColorDialog QML Type

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

Import Statement: import QtQuick.Dialogs
Since: Qt 6.4
Inherits:

Dialog

プロパティ

詳細な説明

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.NoButtonsOpenCancel ボタンを表示しない(「ライブダイアログ」に便利)。
ColorDialog.NoEyeDropperButtonEye Dropper ボタンを表示しない。この値は Qt 6.6 で追加されました。
ColorDialog.DontUseNativeDialog非ネイティブのクイック実装をダイアログに強制的に使用させます。

selectedColor : color

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

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

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


©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。