En esta página

ColorDialog QML Type

Un cuadro de diálogo de colores nativo. Más...

Import Statement: import Qt.labs.platform
Inherits:

Dialog

Status: Deprecated since 6.9

Este tipo está obsoleto desde Qt Labs Platform 6.9. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

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.

Un cuadro de diálogo de colores nativo

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 += widgets

Crea 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:

ConstanteDescripción
ColorDialog.ShowAlphaChannelPermite al usuario seleccionar el componente alfa de un color.
ColorDialog.NoButtonsNo 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.