ColorDialog QML Type
Un diálogo de colores. Más...
| Import Statement: | import QtQuick.Dialogs |
| Since: | Qt 6.4 |
| Inherits: |
Propiedades
- options : flags
- selectedColor : color
Descripción detallada
El tipo ColorDialog proporciona una API QML para diálogos de color.

Para mostrar un diálogo de color, construya una instancia de ColorDialog, establezca las propiedades deseadas y llame a open(). La propiedad selectedColor puede utilizarse para determinar el color seleccionado inicialmente en el diálogo.
MenuItem {
text: qsTr("Color")
onTriggered: colorDialog.open()
}
ColorDialog {
id: colorDialog
selectedColor: document.color
onAccepted: document.color = selectedColor
}
MyDocument {
id: document
}Disponibilidad
Un diálogo de color nativo de la plataforma está actualmente disponible en las siguientes plataformas:
- iOS
- Linux (cuando se ejecuta con el tema de plataforma GTK+)
- macOS
Qt Quick Dialogs utiliza una implementación de Qt Quick como alternativa en plataformas que no disponen de una implementación nativa.
Documentación de propiedades
options : flags
Esta propiedad contiene las distintas opciones que afectan al aspecto del diálogo.
Por defecto, todas las opciones están desactivadas.
Las opciones deben establecerse antes de mostrar el diálogo. Establecerlas mientras el diálogo está visible no garantiza que tenga un efecto inmediato en el diálogo (dependiendo de la opción y de la plataforma).
Opciones disponibles:
| Constante | Descripción |
|---|---|
ColorDialog.ShowAlphaChannel | Mostrar un deslizador y campos de entrada adicionales para el valor alfa. |
ColorDialog.NoButtons | No mostrar los botones Open y Cancel (útil para "diálogos en vivo"). |
ColorDialog.NoEyeDropperButton | No mostrar el botón Eye Dropper. Este valor se añadió en Qt 6.6. |
ColorDialog.DontUseNativeDialog | Obliga al diálogo a utilizar una implementación rápida no nativa. |
selectedColor : color
Esta propiedad contiene el color actualmente seleccionado en el diálogo.
La señal accepted() puede ser manejada para obtener la selección final. Cuando el usuario ha pulsado Open para aceptar un color, un manejador de señal para la señal accepted() puede consultar la propiedad selectedColor para obtener el color final que fue seleccionado por el usuario.
Véase también 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.