QColorDialog Class
QColorDialog 클래스는 색상을 지정하기 위한 대화 상자 위젯을 제공합니다. 더 보기...
Header: | #include <QColorDialog> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
상속합니다: | QDialog |
- 상속된 멤버를 포함한 모든 멤버 목록
- QColorDialog는 표준 대화 상자의 일부입니다.
공용 유형
enum | ColorDialogOption { ShowAlphaChannel, NoButtons, NoEyeDropperButton, DontUseNativeDialog } |
flags | ColorDialogOptions |
속성
- currentColor : QColor
- options : ColorDialogOptions
공용 함수
QColorDialog(QWidget *parent = nullptr) | |
QColorDialog(const QColor &initial, QWidget *parent = nullptr) | |
virtual | ~QColorDialog() |
QColor | currentColor() const |
void | open(QObject *receiver, const char *member) |
QColorDialog::ColorDialogOptions | options() const |
QColor | selectedColor() const |
void | setCurrentColor(const QColor &color) |
void | setOption(QColorDialog::ColorDialogOption option, bool on = true) |
void | setOptions(QColorDialog::ColorDialogOptions options) |
bool | testOption(QColorDialog::ColorDialogOption option) const |
재구현된 공용 함수
virtual void | setVisible(bool visible) override |
시그널
void | colorSelected(const QColor &color) |
void | currentColorChanged(const QColor &color) |
정적 공용 멤버
QColor | customColor(int index) |
int | customCount() |
QColor | getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions()) |
void | setCustomColor(int index, QColor color) |
void | setStandardColor(int index, QColor color) |
QColor | standardColor(int index) |
재구현된 보호 함수
virtual void | changeEvent(QEvent *e) override |
virtual void | done(int result) override |
상세 설명
색상 대화 상자의 기능은 사용자가 색상을 선택할 수 있도록 하는 것입니다. 예를 들어 그리기 프로그램에서 사용자가 브러시 색상을 설정할 수 있도록 하는 데 사용할 수 있습니다.
정적 함수는 모달 색상 대화 상자를 제공합니다.
정적 getColor() 함수는 대화 상자를 표시하고 사용자가 색상을 지정할 수 있도록 합니다. 이 함수를 사용하여 사용자가 투명도 수준의 색상을 선택할 수도 있습니다. ShowAlphaChannel 옵션을 추가 인수로 전달하면 됩니다.
사용자는 customCount()에 다양한 사용자 지정 색상을 저장할 수 있습니다. 사용자 지정 색상은 모든 색상 대화 상자에서 공유되며 프로그램을 실행하는 동안 기억됩니다. 사용자 지정 색상을 설정하려면 setCustomColor()를 사용하고, 색상을 가져오려면 customColor()를 사용합니다.
"화면 색상 선택" 버튼을 누르면 커서가 헤어크로스로 바뀌고 화면의 색상이 스캔됩니다. 사용자는 마우스 또는 Enter 버튼을 클릭하여 색상을 선택할 수 있습니다. Esc 키를 누르면 이 모드로 들어가기 전에 마지막으로 선택한 색상으로 복원됩니다.
표준 대화상자 예제에서는 QColorDialog와 다른 내장 Qt 대화상자를 사용하는 방법을 보여줍니다.
QColor, QFileDialog, QFontDialog 및 표준 대화 상자 예제를참조하십시오 .
멤버 유형 문서
열거형 QColorDialog::ColorDialogOption
플래그 QColorDialog::ColorDialogOptions
색상 대화 상자의 모양과 느낌에 영향을 주는 다양한 옵션을 지정하는 Enum입니다.
상수 | 값 | 설명 |
---|---|---|
QColorDialog::ShowAlphaChannel | 0x00000001 | 사용자가 색의 알파 성분을 선택할 수 있도록 허용합니다. |
QColorDialog::NoButtons | 0x00000002 | OK 및 Cancel 버튼을 표시하지 않습니다. ('라이브 대화 상자'에 유용합니다.) |
QColorDialog::NoEyeDropperButton | 0x00000008 | Eye Dropper 버튼을 숨깁니다. 이 값은 Qt 6.6에 추가되었습니다. |
QColorDialog::DontUseNativeDialog | 0x00000004 | 운영체제의 기본 색상 대화상자 대신 Qt의 표준 색상 대화상자를 사용합니다. |
ColorDialogOptions 유형은 QFlags<ColorDialogOption>에 대한 typedef입니다. 이 유형은 ColorDialogOption 값의 OR 조합을 저장합니다.
options, setOption(), testOption() 및 windowModality()도 참조하세요 .
속성 문서
currentColor : QColor
이 속성은 대화 상자에서 현재 선택된 색을 유지합니다.
함수에 액세스합니다:
QColor | currentColor() const |
void | setCurrentColor(const QColor &color) |
알림 신호:
void | currentColorChanged(const QColor &color) |
options : ColorDialogOptions
이 속성에는 대화 상자의 모양과 느낌에 영향을 주는 다양한 옵션이 있습니다.
기본적으로 모든 옵션은 비활성화되어 있습니다.
대화 상자를 표시하기 전에 옵션을 설정해야 합니다. 대화 상자가 표시된 상태에서 옵션을 설정해도 옵션 및 플랫폼에 따라 대화 상자에 즉각적인 영향을 미치지는 않습니다.
기능에 액세스합니다:
QColorDialog::ColorDialogOptions | options() const |
void | setOptions(QColorDialog::ColorDialogOptions options) |
setOption() 및 testOption()도 참조하세요 .
멤버 함수 문서
[explicit]
QColorDialog::QColorDialog(QWidget *parent = nullptr)
주어진 parent 으로 색상 대화 상자를 구성합니다.
[explicit]
QColorDialog::QColorDialog(const QColor &initial, QWidget *parent = nullptr)
주어진 parent 및 지정된 initial 색상으로 색상 대화 상자를 만듭니다.
[virtual noexcept]
QColorDialog::~QColorDialog()
색상 대화 상자를 삭제합니다.
[override virtual protected]
void QColorDialog::changeEvent(QEvent *e)
다시 구현합니다: QWidget::changeEvent(QEvent * 이벤트).
[signal]
void QColorDialog::colorSelected(const QColor &color)
이 신호는 사용자가 OK 을 클릭하여 사용할 색상을 선택한 직후에 전송됩니다. 선택한 색상은 color 에 의해 지정됩니다.
색상 및 currentColorChanged()도 참조하세요 .
[signal]
void QColorDialog::currentColorChanged(const QColor &color)
이 신호는 대화 상자에서 현재 색상이 변경될 때마다 발산됩니다. 현재 색상은 color 에 의해 지정됩니다.
참고: 속성에 대한 알림 신호 currentColor.
색상 및 colorSelected()도 참조하세요 .
[static]
QColor QColorDialog::customColor(int index)
주어진 index 값의 사용자 정의 색상을 QColor 값으로 반환합니다.
setCustomColor()도 참조하세요 .
[static]
int QColorDialog::customCount()
QColorDialog 에서 지원하는 사용자 지정 색상의 수를 반환합니다. 모든 색상 대화 상자는 동일한 사용자 지정 색상을 공유합니다.
[override virtual protected]
void QColorDialog::done(int result)
재구현합니다: QDialog::done(int r).
대화 상자를 닫고 결과 코드를 result 로 설정합니다. 이 대화 상자가 exec()와 함께 표시되면 done()는 로컬 이벤트 루프를 종료하고 exec()는 result 을 반환합니다.
QDialog::done()도 참조하세요 .
[static]
QColor QColorDialog::getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions())
지정된 창 title (또는 지정되지 않은 경우 "색상 선택")이 있는 모달 색상 대화 상자를 팝업하고 사용자가 색상을 선택할 수 있도록 한 다음 해당 색상을 반환합니다. 색상은 처음에 initial 로 설정됩니다. 이 대화 상자는 parent 의 자식입니다. 사용자가 대화 상자를 취소하면 유효하지 않은( QColor::isValid() 참조) 색상을 반환합니다.
options 인수를 사용하면 대화 상자를 사용자 지정할 수 있습니다.
void QColorDialog::open(QObject *receiver, const char *member)
대화 상자를 열고 colorSelected() 신호를 receiver 및 member 에 지정된 슬롯에 연결합니다.
대화 상자가 닫히면 신호가 슬롯에서 연결이 끊어집니다.
QColor QColorDialog::selectedColor() const
사용자가 OK 또는 이와 동등한 버튼을 클릭하여 선택한 색상을 반환합니다.
참고: 사용자가 사용할 색상을 최종적으로 선택하기 전에 다른 색상을 선택할 수 있으므로 이 색상은 currentColor 속성이 보유한 색상과 항상 같지는 않습니다.
[static]
void QColorDialog::setCustomColor(int index, QColor color)
index 의 사용자 지정 색상을 QColor color 값으로 설정합니다.
참고: 이 기능은 macOS 플랫폼의 기본 색상 대화상자에는 적용되지 않습니다. 그래도 이 기능이 필요한 경우에는 QColorDialog::DontUseNativeDialog 옵션을 사용하세요.
customColor()도 참조하세요 .
void QColorDialog::setOption(QColorDialog::ColorDialogOption option, bool on = true)
on 이 참이면 지정된 option 을 활성화하도록 설정하고, 그렇지 않으면 지정된 option 을 지웁니다.
options 및 testOption()도 참조하세요 .
[static]
void QColorDialog::setStandardColor(int index, QColor color)
index 의 표준 색상을 QColor color 값으로 설정합니다.
참고: 이 기능은 macOS 플랫폼의 기본 색상 대화상자에는 적용되지 않습니다. 그래도 이 기능이 필요한 경우에는 QColorDialog::DontUseNativeDialog 옵션을 사용하세요.
standardColor()도 참조하세요 .
[override virtual]
void QColorDialog::setVisible(bool visible)
다시 구현합니다: QDialog::setVisible(bool 표시).
대화 상자의 표시 여부를 변경합니다. visible 이 참이면 대화 상자가 표시되고, 그렇지 않으면 대화 상자가 숨겨집니다.
[static]
QColor QColorDialog::standardColor(int index)
주어진 index 의 표준 색상을 QColor 값으로 반환합니다.
setStandardColor()도 참조하세요 .
bool QColorDialog::testOption(QColorDialog::ColorDialogOption option) const
지정된 option 이 활성화된 경우 true
을 반환하고, 그렇지 않으면 false 를 반환합니다.
© 2025 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.