En esta página

ColorDialog QML Type

Un 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 QML para diálogos de color.

El diálogo de colores puede personalizarse mediante la propiedad opciones

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:

ConstanteDescripción
ColorDialog.ShowAlphaChannelMostrar un deslizador y campos de entrada adicionales para el valor alfa.
ColorDialog.NoButtonsNo mostrar los botones Open y Cancel (útil para "diálogos en vivo").
ColorDialog.NoEyeDropperButtonNo mostrar el botón Eye Dropper. Este valor se añadió en Qt 6.6.
ColorDialog.DontUseNativeDialogObliga 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.