En esta página

ColorDialog QML Type

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

Import Statement: import QtQuick.Dialogs
Since: Qt 6.4
Inherits:

Dialog

Propiedades

Descripción detallada

El tipo ColorDialog proporciona una API de QML para los cuadros de diálogo de color.

El cuadro de diálogo de colores se puede personalizar mediante la propiedad «options»

Para mostrar un cuadro de diálogo de color, crea una instancia de ColorDialog, configura las propiedades deseadas y llama a ` open()`. La propiedad ` selectedColor ` se puede utilizar para determinar el color seleccionado inicialmente en el cuadro de diálogo.

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

ColorDialog {
    id: colorDialog
    selectedColor: document.color
    onAccepted: document.color = selectedColor
}

MyDocument {
    id: document
}

Disponibilidad

Actualmente, hay un cuadro de diálogo de color nativo de la plataforma disponible en las siguientes plataformas:

  • iOS
  • Linux (cuando se ejecuta con el tema de la plataforma GTK+)
  • macOS

Qt Quick Dialogs utiliza una implementación de ` Qt Quick ` como alternativa en aquellas plataformas que no disponen de una implementación nativa.

Documentación de propiedades

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.ShowAlphaChannelMuestra un control deslizante y campos de entrada adicionales para el valor alfa.
ColorDialog.NoButtonsNo muestra los botones « Open » y « Cancel » (útil para «cuadros de diálogo en tiempo real»).
ColorDialog.NoEyeDropperButtonNo muestra el botón « Eye Dropper ». Este valor se añadió en Qt 6.6.
ColorDialog.DontUseNativeDialogObliga al cuadro de diálogo a utilizar una implementación Quick no nativa.

selectedColor : color

Esta propiedad almacena el color seleccionado actualmente en el cuadro de diálogo.

Se puede gestionar la señal ` accepted()` para obtener la selección final. Cuando el usuario ha hecho clic en « Open » para aceptar un color, un gestor de señales para la señal ` accepted()` puede consultar la propiedad `selectedColor` para obtener el color final 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.