ColorDialog QML Type
Un cuadro de diálogo de colores nativo. Más...
| Import Statement: | import Qt.labs.platform |
| Inherits: | |
| Status: | Deprecated since 6.9 |
Este tipo está obsoleto desde Qt Labs Platform 6.9. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- color : color
- currentColor : color
- options : flags
Descripción detallada
Utiliza en su lugar ` QtQuick.Dialogs ColorDialog `.
El tipo ColorDialog proporciona una API QML para los cuadros de diálogo de color nativos de la plataforma.

Para mostrar un cuadro de diálogo de colores, cree una instancia de ColorDialog, establezca las propiedades deseadas y llame a open(). La propiedad currentColor se puede utilizar para determinar el color seleccionado actualmente en el cuadro de diálogo. La propiedad color solo se actualiza una vez que se ha realizado la selección final al aceptar el cuadro de diálogo.
MenuItem {
text: "Color"
onTriggered: colorDialog.open()
}
ColorDialog {
id: colorDialog
currentColor: document.color
}
MyDocument {
id: document
color: colorDialog.color
}Disponibilidad
Actualmente, el cuadro de diálogo de colores nativo de la plataforma está disponible en las siguientes plataformas:
- iOS
- Linux (cuando se ejecuta con el tema de la plataforma GTK+)
- macOS
El módulo Qt Labs Platform utiliza Qt Widgets como alternativa en aquellas plataformas que no dispongan de una implementación nativa. Por lo tanto, las aplicaciones que utilicen tipos del módulo Qt Labs Platform deben vincularse a QtWidgets y utilizar QApplication en lugar de QGuiApplication.
Para vincularse a la biblioteca QtWidgets, añade lo siguiente a tu archivo de proyecto qmake:
QT += widgetsCrea una instancia de QApplication en main():
#include <QApplication>
#include <QQmlApplicationEngine>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QQmlApplicationEngine engine;
engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
return app.exec();
}Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.
Véase también QtQuick.Dialogs::ColorDialog.
Documentación de propiedades
color : color
Esta propiedad contiene el color final aceptado.
A diferencia de la propiedad « currentColor », la propiedad « color » no se actualiza mientras el usuario selecciona colores en el cuadro de diálogo, sino solo después de que se haya realizado la selección final. Es decir, cuando el usuario ha hecho clic en « OK » para aceptar un color. Como alternativa, se puede gestionar la señal « accepted()» para obtener la selección final.
Véase también currentColor y accepted().
currentColor : color
Esta propiedad almacena el color seleccionado actualmente en el cuadro de diálogo.
A diferencia de la propiedad « color », la propiedad « currentColor » se actualiza mientras el usuario selecciona colores en el cuadro de diálogo, incluso antes de que se haya realizado la selección definitiva.
Véase también color.
options : flags
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).
Opciones disponibles:
| Constante | Descripción |
|---|---|
ColorDialog.ShowAlphaChannel | Permite al usuario seleccionar el componente alfa de un color. |
ColorDialog.NoButtons | No muestra los botones « OK » y « Cancel » (útil para «cuadros de diálogo en tiempo real»). |
© 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.