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.