En esta página

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

Tipos públicos

enum ColorDialogOption { ShowAlphaChannel, NoButtons, NoEyeDropperButton, DontUseNativeDialog }
flags ColorDialogOptions

Propiedades

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.

Un cuadro de diálogo de colores con el estilo del widget Fusion.

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.

ConstanteValorDescripción
QColorDialog::ShowAlphaChannel0x00000001Permite al usuario seleccionar el componente alfa de un color.
QColorDialog::NoButtons0x00000002No muestra los botones « OK » y « Cancel ». (Útil para «cuadros de diálogo en tiempo real»).
QColorDialog::NoEyeDropperButton0x00000008Oculta el botón « Eye Dropper ». Este valor se añadió en Qt 6.6.
QColorDialog::DontUseNativeDialog0x00000004Utiliza 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».

Véase también options y setOption().

© 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.