ColorDialog QML Type

Un diálogo de color nativo. Más...

Este tipo está obsoleto desde Qt.labs.platform 6.9. Desaconsejamos su uso en código nuevo.

• Lista de todos los miembros, incluyendo los heredados

Propiedades

• color : color
• currentColor : color
• options : flags

Descripción detallada

Utilice QtQuick.Dialogs ColorDialog en su lugar.

El tipo ColorDialog proporciona una API QML para diálogos de color nativos de la plataforma.

Para mostrar un diálogo de color, construya una instancia de ColorDialog, establezca las propiedades deseadas y llame a open(). La propiedad currentColor puede utilizarse para determinar el color seleccionado actualmente en el diálogo. La propiedad color se actualiza sólo después de que se haya realizado la selección final aceptando el diálogo.

MenuItem {
    text: "Color"
    onTriggered: colorDialog.open()
}

ColorDialog {
    id: colorDialog
    currentColor: document.color
}

MyDocument {
    id: document
    color: colorDialog.color
}

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

El módulo Qt Labs Platform utiliza Qt Widgets como alternativa en plataformas que no disponen de una implementación nativa. Por lo tanto, las aplicaciones que utilizan tipos del módulo Qt Labs Platform deben enlazar con QtWidgets y utilizar QApplication en lugar de QGuiApplication.

Para enlazar con la biblioteca QtWidgets, añada lo siguiente al archivo de proyecto qmake:

QT += widgets

Crear 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();
}

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 está seleccionando colores en el diálogo, sino sólo después de haber realizado la selección final. Es decir, cuando el usuario ha pulsado OK para aceptar un color. Alternativamente, se puede manejar la señal accepted() para obtener la selección final.

Véase también currentColor y accepted().

currentColor : color

Esta propiedad contiene el color actualmente seleccionado en el diálogo.

A diferencia de la propiedad color, la propiedad currentColor se actualiza mientras el usuario está seleccionando colores en el diálogo, incluso antes de que se haya realizado la selección final.

Véase también color.

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: