QColorDialog Class
La clase QColorDialog proporciona un control de diálogo para especificar colores. Más información...
| Encabezado: | #include <QColorDialog> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredan: | QDialog |
- Lista de todos los miembros, incluidos los heredados
- QColorDialog forma parte de Diálogos estándar.
Tipos públicos
| enum | ColorDialogOption { ShowAlphaChannel, NoButtons, NoEyeDropperButton, DontUseNativeDialog } |
| flags | ColorDialogOptions |
Propiedades
- currentColor : QColor
- options : ColorDialogOptions
Funciones públicas
| 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 |
Funciones públicas reimplementadas
| virtual void | setVisible(bool visible) override |
Señales
| void | colorSelected(const QColor &color) |
| void | currentColorChanged(const QColor &color) |
Miembros públicos estáticos
| 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) |
Funciones protegidas reimplementadas
| virtual void | changeEvent(QEvent *e) override |
| virtual void | done(int result) override |
Descripción detallada
La función del cuadro de diálogo de colores es permitir a los usuarios elegir colores. Por ejemplo, se podría utilizar en un programa de dibujo para que el usuario pueda establecer el color del pincel.
Las funciones estáticas proporcionan cuadros de diálogo de color modales.
La función estática ` getColor()` muestra el cuadro de diálogo y permite al usuario especificar un color. Esta función también se puede utilizar para que los usuarios elijan un color con un nivel de transparencia: basta con pasar la opción ` ShowAlphaChannel ` como argumento adicional.
El usuario puede almacenar diferentes colores personalizados mediante ` customCount()`. Los colores personalizados son compartidos por todos los cuadros de diálogo de color y se recuerdan durante la ejecución del programa. Utiliza ` setCustomColor()` para establecer los colores personalizados y ` customColor()` para recuperarlos.
Al pulsar el botón «Seleccionar color de la pantalla», el cursor se convierte en una cruz y se escanean los colores de la pantalla. El usuario puede seleccionar uno haciendo clic con el ratón o pulsando la tecla Intro. Al pulsar Esc se restablece el último color seleccionado antes de entrar en este modo.
El ejemplo «Standard Dialogs » muestra cómo utilizar QColorDialog, así como otros cuadros de diálogo integrados en Qt.

Véase también QColor, QFileDialog, QFontDialog y el ejemplo «Diálogos estándar».
Documentación sobre los tipos de miembros
enum QColorDialog::ColorDialogOption
flags QColorDialog::ColorDialogOptions
Esta enumeración especifica diversas opciones que afectan al aspecto y la presentación de un cuadro de diálogo de colores.
| Constante | Valor | Descripción |
|---|---|---|
QColorDialog::ShowAlphaChannel | 0x00000001 | Permite al usuario seleccionar el componente alfa de un color. |
QColorDialog::NoButtons | 0x00000002 | No muestra los botones « OK » y « Cancel ». (Útil para «cuadros de diálogo en tiempo real»). |
QColorDialog::NoEyeDropperButton | 0x00000008 | Oculta el botón « Eye Dropper ». Este valor se añadió en Qt 6.6. |
QColorDialog::DontUseNativeDialog | 0x00000004 | Utiliza el cuadro de diálogo de color estándar de Qt en lugar del cuadro de diálogo de color nativo del sistema operativo. |
El tipo `ColorDialogOptions` es un `typedef` para ` QFlags<ColorDialogOption>`. Almacena una combinación OR de valores de `ColorDialogOption`.
Véase también options, setOption(), testOption() y windowModality().
Documentación de la propiedad
currentColor : QColor
Esta propiedad contiene el color seleccionado actualmente en el cuadro de diálogo
Funciones de acceso:
| QColor | currentColor() const |
| void | setCurrentColor(const QColor &color) |
Señal del notificador:
| void | currentColorChanged(const QColor &color) |
options : ColorDialogOptions
Esta propiedad contiene las distintas opciones que influyen en el aspecto y el comportamiento del cuadro de diálogo
Por defecto, todas las opciones están desactivadas.
Las opciones deben configurarse antes de mostrar el cuadro de diálogo. No se garantiza que su configuración mientras el cuadro de diálogo está visible tenga un efecto inmediato en el mismo (dependiendo de la opción y de la plataforma).
Funciones de acceso:
| QColorDialog::ColorDialogOptions | options() const |
| void | setOptions(QColorDialog::ColorDialogOptions options) |
Véase también setOption() y testOption().
Documentación de las funciones de miembro
[explicit] QColorDialog::QColorDialog(QWidget *parent = nullptr)
Crea un cuadro de diálogo de colores con el valor « parent » indicado.
[explicit] QColorDialog::QColorDialog(const QColor &initial, QWidget *parent = nullptr)
Crea un cuadro de diálogo de color con el « parent » indicado y el color « initial » especificado.
[virtual noexcept] QColorDialog::~QColorDialog()
Cierra el cuadro de diálogo de color.
[override virtual protected] void QColorDialog::changeEvent(QEvent *e)
Reimplementa: QWidget::changeEvent(QEvent *event).
[signal] void QColorDialog::colorSelected(const QColor &color)
Esta señal se emite justo después de que el usuario haya hecho clic en OK para seleccionar un color que desea utilizar. El color elegido se especifica mediante color.
Véase también color y currentColorChanged().
[signal] void QColorDialog::currentColorChanged(const QColor &color)
Esta señal se emite cada vez que cambia el color actual en el cuadro de diálogo. El color actual viene especificado por color.
Nota: Señalde notificación para la propiedad currentColor.
Véase también color y colorSelected().
[static] QColor QColorDialog::customColor(int index)
Devuelve el color personalizado de la dirección index como un valor de tipo QColor.
Véase también setCustomColor().
[static] int QColorDialog::customCount()
Devuelve el número de colores personalizados que admite QColorDialog. Todos los cuadros de diálogo de colores comparten los mismos colores personalizados.
[override virtual protected] void QColorDialog::done(int result)
Reimplementa: ` QDialog::done(int r)`.
Cierra el cuadro de diálogo y establece su código de resultado en « result ». Si este cuadro de diálogo se muestra con « exec()», la función «done()» provoca que finalice el bucle de eventos local y que « exec()» devuelva « result ».
Véase también QDialog::done().
[static] QColor QColorDialog::getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions())
Muestra un cuadro de diálogo modal de color con el title especificado para la ventana (o «Seleccionar color» si no se especifica ninguno), permite al usuario elegir un color y devuelve dicho color. El color se establece inicialmente en initial. El cuadro de diálogo es un elemento secundario de parent. Devuelve un color no válido (véase QColor::isValid()) si el usuario cancela el cuadro de diálogo.
El argumento « options » permite personalizar el cuadro de diálogo.
void QColorDialog::open(QObject *receiver, const char *member)
Abre el cuadro de diálogo y conecta su señal « colorSelected()» a las ranuras especificadas en « receiver » y « member ».
La señal se desconectará de la ranura cuando se cierre el cuadro de diálogo.
QColor QColorDialog::selectedColor() const
Devuelve el color que el usuario ha seleccionado al hacer clic en el botón « OK » o en un botón equivalente.
Nota: Este color no siempre coincide con el color que contiene la propiedad « currentColor », ya que el usuario puede elegir diferentes colores antes de seleccionar finalmente el que desea utilizar.
[static] void QColorDialog::setCustomColor(int index, QColor color)
Establece el color personalizado de « index » en el valor de « QColor » color.
Nota: Esta función no se aplica al cuadro de diálogo de colores nativo de la plataforma macOS. Si aún así necesitas esta función, utiliza la opción QColorDialog::DontUseNativeDialog.
Véase también customColor().
void QColorDialog::setOption(QColorDialog::ColorDialogOption option, bool on = true)
Establece que el option especificado esté habilitado si on es verdadero; en caso contrario, deshabilita el option especificado.
Véanse también options y testOption().
[static] void QColorDialog::setStandardColor(int index, QColor color)
Establece el color predeterminado de « index » en el valor de « QColor » color.
Nota: Esta función no se aplica al cuadro de diálogo «Native Color» en la plataforma macOS. Si aún así necesitas esta función, utiliza la opción QColorDialog::DontUseNativeDialog.
Véase también standardColor().
[override virtual] void QColorDialog::setVisible(bool visible)
Reimplementa: ` QDialog::setVisible` (bool visible).
Cambia la visibilidad del cuadro de diálogo. Si visible es true, se muestra el cuadro de diálogo; en caso contrario, se oculta.
[static] QColor QColorDialog::standardColor(int index)
Devuelve el color estándar correspondiente al valor de « index » proporcionado como un valor de « QColor ».
Véase también setStandardColor().
bool QColorDialog::testOption(QColorDialog::ColorDialogOption option) const
Devuelve « true » si la función « option » está habilitada; en caso contrario, devuelve «false».
© 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.