En esta página

Estilo «Imagine»

El estilo «Imagine» se basa en recursos gráficos configurables. Más información...

Declaración de importación: import QtQuick.Controls.Imagine
Desde: Qt 5.10

Propiedades asociadas

Descripción detallada

El estilo «Imagine» se basa en recursos gráficos. El estilo incluye un conjunto predeterminado de imágenes, pero estas se pueden cambiar fácilmente indicando un directorio con imágenes que sigan una convención de nomenclatura predefinida.

Galería de controles al estilo Imagine

El estilo «Imagine» con las imágenes predeterminadas

Para ejecutar una aplicación con el estilo «Imagine», consulta «Uso de estilos en los controles de Qt Quick ».

Nombres de archivo

Los archivos de imagen se nombran siguiendo la siguiente convención:

<control>-<element>-<states>

Las secciones « <control> » y « <element> » son obligatorias, pero la sección « <states> » es opcional. Por ejemplo, si se proporciona un único archivo llamado « "button-background.9.png" » para « Button », se utilizará para todos los estados que admite « Button ». Corresponde al desarrollador decidir el conjunto de estados para los que proporcionará imágenes. No obstante, se recomienda proporcionar imágenes para los estados de control más habituales siempre que sea posible, como disabled, pressed, etc. De este modo, se garantiza que los controles interactivos se comporten visualmente tal y como el usuario final esperaría.

Referencia de elementos

La siguiente tabla enumera los elementos compatibles con cada control, junto con los posibles estados de dicho elemento y la extensión de archivo que se espera. Un elemento es una imagen que representa una parte visual concreta del control. Por ejemplo, el elemento "background" de Button representa su background.

ControlElementoEstadosExtensión
ApplicationWindowfondoactivo.9.png (o .png)
BusyIndicatoranimacióndesactivada, en ejecución, reflejada, al pasar el cursor.webp
fondoigual que el anterior.webp
Buttonfondodesactivado, pulsado, marcado, marcable, enfocado, resaltado, plano, reflejado, al pasar el cursor.9.png
CheckBoxfondodesactivado, pulsado, marcado, parcialmente marcado, enfocado, invertido, al pasar el cursor.9.png (o .png)
indicadorigual que el anterior.png
CheckDelegatefondodesactivado, pulsado, marcado, parcialmente marcado, enfocado, resaltado, invertido, al pasar el cursor.9.png (o .png)
indicadorigual que el anterior.png
ComboBoxfondodesactivado, pulsado, editable, abierto, enfocado, reflejado, al pasar el cursor, plano.9.png (o .png)
indicadorigual que el anterior.png
ventana emergenteigual que el anterior.9.png (o .png)
DelayButtonfondodesactivado, pulsado, marcado, marcable, enfocado, reflejado, al pasar el cursor.9.png (o .png)
progresoigual que el anterior.9.png (o .png)
máscaraigual que arriba.9.png (o .png)
Dialfondo1desactivado, pulsado, enfocado, invertido, al pasar el cursor.9.png (o .png)
controladorigual que el anterior.9.png (o .png)
Dialogfondomodal, atenuado.9.png (o .png)
títuloigual que el anterior.9.png (o .png)
superposiciónmodal.9.png (o .png)
DialogButtonBoxfondodesactivado, reflejado.9.png (o .png)
Drawerfondomodal, atenuado, arriba, izquierda, derecha, abajo.9.png (o .png)
superposiciónmodal.9.png (o .png)
Framefondodesactivado, reflejado.9.png (o .png)
GroupBoxfondodesactivado, reflejado.9.png (o .png)
títuloigual que el anterior.9.png (o .png)
ItemDelegatefondodesactivado, pulsado, enfocado, resaltado, invertido, al pasar el cursor.9.png (o .png)
Labelfondodesactivado, invertido, al pasar el cursor.9.png (o .png)
Menufondomodal, atenuado.9.png (o .png)
superposiciónmodal.9.png (o .png)
MenuItemflechadesactivado, pulsado, marcado, enfocado, resaltado, invertido, al pasar el cursor.png
fondoigual que el anterior.9.png (o .png)
indicadorigual que el anterior.png
MenuSeparatorfondodesactivado, reflejado.9.png (o .png)
separadorigual que el anterior.9.png (o .png)
Pagefondodesactivado, reflejado.9.png (o .png)
PageIndicatorfondodesactivado, reflejado, al pasar el cursor.9.png (o .png)
delegardesactivado, pulsado, activo, reflejado, al pasar el cursor.png
Panefondodesactivado, reflejado.9.png (o .png)
Popupfondomodal, atenuado.9.png (o .png)
superposiciónmodal.9.png (o .png)
ProgressBaranimacióndesactivado, reflejado, al pasar el cursor.png
fondodesactivado, indeterminado, invertido, al pasar el cursor.9.png (o .png)
máscaraigual que el anterior.9.png (o .png)
progresoigual que el anterior.9.png (o .png)
RadioButtonfondodesactivado, pulsado, marcado, enfocado, invertido, al pasar el cursor.9.png (o .png)
indicadorigual que el anterior.png
RadioDelegatefondodesactivado, pulsado, marcado, enfocado, resaltado, invertido, al pasar el cursor.9.png (o .png)
indicadorigual que el anterior.png
RangeSliderfondovertical, horizontal, desactivado, enfocado, invertido, al pasar el cursor.9.png (o .png)
RangeSliderprogresoigual que el anterior.9.png (o .png)
controlprimero, segundo, vertical, horizontal, desactivado, pulsado, enfocado, reflejado, al pasar el cursor.png
RoundButtonfondodesactivado, pulsado, marcado, marcable, enfocado, resaltado, plano, reflejado, al pasar el cursor.9.png (o .png)
ScrollBarfondovertical, horizontal, desactivado, interactivo, pulsado, reflejado, al pasar el cursor.9.png (o .png)
controladorigual que arriba.9.png (o .png)
ScrollIndicatorfondovertical, horizontal, desactivado, reflejado, al pasar el cursor.9.png (o .png)
controladorigual que arriba.9.png (o .png)
ScrollViewfondodesactivado, reflejado.9.png (o .png)
Sliderfondovertical, horizontal, desactivado, pulsado, enfocado, reflejado, al pasar el cursor.9.png (o .png)
controligual que arriba.9.png (o .png)
progresoigual que el anterior.9.png (o .png)
SpinBoxfondodesactivado, editable, seleccionado, invertido, al pasar el cursor.9.png (o .png)
editordesactivado, con foco, reflejado, al pasar el cursor.9.png (o .png)
indicadorarriba, abajo, desactivado, editable, pulsado, con foco, invertido, al pasar el cursor.9.png (o .png)
StackViewfondodesactivado, reflejado.9.png (o .png)
SwipeDelegatefondodesactivado, pulsado, enfocado, resaltado, reflejado, al pasar el cursor.9.png (o .png)
SwipeViewfondovertical, horizontal, desactivado, interactivo, seleccionado, invertido.9.png (o .png)
Switchfondodesactivado, pulsado, marcado, enfocado, invertido, al pasar el cursor.9.png (o .png)
controligual que el anterior.9.png (o .png)
indicadorigual que el anterior.9.png (o .png)
SwitchDelegatefondodesactivado, pulsado, marcado, enfocado, resaltado, invertido, al pasar el cursor.9.png (o .png)
controladorigual que el anterior.9.png (o .png)
indicadorigual que el anterior.9.png (o .png)
TabBarfondodesactivado, encabezado, pie de página, reflejado.9.png (o .png)
TabButtonfondodesactivado, pulsado, marcado, enfocado, invertido, al pasar el cursor.9.png (o .png)
TextAreafondodesactivado, con foco, invertido, al pasar el cursor.9.png (o .png)
TextFieldfondodesactivado, enfocado, invertido, al pasar el cursor.9.png (o .png)
ToolBarfondodesactivado, encabezado, pie de página, reflejado.9.png (o .png)
ToolButtonfondodesactivado, pulsado, marcado, marcable, enfocado, resaltado, plano, reflejado, al pasar el cursor.9.png (o .png)
ToolSeparatorfondovertical, horizontal, desactivado, reflejado.9.png (o .png)
separadorigual que el anterior.9.png (o .png)
ToolTipfondo.9.png (o .png)
Tumblerfondodesactivado, enfocado, reflejado, al pasar el cursor.9.png (o .png)

Nota: 1) El estilo «Imagine» del Dial aún no es compatible con las propiedades « startAngle » y « endAngle », introducidas en Qt 6.6, y, en su lugar, utiliza una imagen de fondo fija.

Ejemplos de recursos

La siguiente tabla recoge ejemplos de recursos (extraídos de los recursos predeterminados del estilo «Imagine») para todos los controles. La lista no es exhaustiva, ya que no todos los elementos necesitan recursos, pero puede servir de guía a la hora de crear tus propios recursos.

La plantilla desde la que se exportaron estos recursos está disponible como proyecto de Sketch.

ControlElementoEstadosActivoNotas
ApplicationWindowAntecedentes

Recurso de fondo de la ventana de la aplicación

Véase la nota al pie 1
superposición

Recurso de superposición de ApplicationWindow

Véase la nota al pie 1
superposiciónmodal

Recurso modal de superposición de ApplicationWindow

Véase la nota al pie 1
Buttonfondo

Recurso de fondo para botones

antecedentesdesactivado

Recurso de fondo de botón desactivado

fondoen foco

Recurso de fondo del botón al recibir el foco

fondopresionado

Recurso de fondo del botón pulsado

fondoa cuadros

Recurso de fondo de botón marcado

fondomarcado, desactivado

Botón: fondo marcado, desactivado, recurso

fondomarcado, enfocado

Botón: fondo marcado, activo en foco

fondomarcado, al pasar el cursor por encima

Recurso de fondo del botón al pasar el cursor por encima

fondoresaltado

Elemento destacado con fondo de botón

fondoresaltado, desactivado

Botón con fondo resaltado: recurso desactivado

fondoresaltado, seleccionado

Botón con fondo resaltado que indica el elemento seleccionado

fondoresaltado, al pasar el cursor por encima

Elemento de fondo del botón resaltado al pasar el cursor por encima

fondoresaltado, pulsado

Botón con fondo resaltado al pulsarlo

fondoresaltado, marcado

Botón con fondo resaltado y casilla marcada

fondoal pasar el cursor por encima

Recurso de fondo del botón al pasar el cursor por encima

fondoplano

Recurso de fondo plano para botones

fondoplano, desactivado

Recurso de botón con fondo plano desactivado

fondoplano, al pasar el cursor

Recurso de fondo plano para botones al pasar el cursor por encima

fondoplano, pulsado

Recurso de botón con fondo plano y aspecto aplanado

fondoliso, a cuadros

Recurso de botón con fondo de cuadros lisos

CheckBoxindicador

Recurso indicador de casilla de selección

indicadordesactivado

Casilla de selección: activo desactivado

indicadorpulsado

Activo con el indicador de casilla de selección marcado

indicadormarcado

Activo marcado con el indicador de casilla de selección

indicadormarcado, pulsado

Casilla de selección marcada: activo seleccionado

indicadormarcado, al pasar el cursor por encima

Indicador de casilla de selección marcada al pasar el cursor por encima del activo

indicadormarcado, con el foco

Casilla de selección que indica que el activo está marcado y tiene el foco

indicadorparcialmente, marcado

Casilla de selección que indica que el activo está parcialmente marcado

indicadorparcialmente, marcado, pulsado

Indicador de casilla de selección parcialmente marcada: activo seleccionado

indicadorparcialmente, marcado, resaltado

Indicador de casilla de selección parcialmente marcada: activo seleccionado

indicadorparcialmente, marcado, al pasar el cursor por encima

Indicador de casilla de selección parcialmente marcada al pasar el cursor por encima del elemento

indicadoren foco

Activo destacado con indicador de casilla de selección

indicadorse situó

Activo con el cursor sobre el indicador de casilla de selección

CheckDelegatefondo

Revisar el recurso de fondo de CheckDelegate

fondodesactivado

Comprobar el activo desactivado de CheckDelegate en segundo plano

fondopulsado

Comprobar el activo de fondo de CheckDelegate al pulsarlo

fondoen primer plano

Recurso de CheckDelegate con el fondo en primer plano

fondoal pasar el cursor

Revisar el recurso de fondo de CheckDelegate al pasar el cursor por encima

indicador

Activo del indicador CheckDelegate

indicadordesactivado

Activo con el indicador «CheckDelegate» desactivado

indicadorpulsado

Activo marcado con el indicador CheckDelegate

indicadormarcado

Activo marcado con el indicador «CheckDelegate»

indicadormarcado, pulsado

Indicador «CheckDelegate» marcado: activo pulsado

indicadormarcado, enfocado

El indicador «CheckDelegate» marca el activo seleccionado

indicadormarcado, al pasar el cursor por encima

Indicador «CheckDelegate»: activo marcado al pasar el cursor por encima

indicadoren foco

Activo en el que se centra el indicador CheckDelegate

indicadoral pasar el cursor

El indicador CheckDelegate se situó en torno al activo

indicadorparcialmente marcado

Indicador «CheckDelegate»: activo parcialmente comprobado

indicadorparcialmente, marcado, pulsado

Indicador «CheckDelegate»: activo pulsado y marcado parcialmente

indicadorparcialmente, marcado, enfocado

Indicador «CheckDelegate»: activo seleccionado parcialmente y con el foco

indicadorparcialmente, marcado, al pasar el cursor por encima

Indicador «CheckDelegate»: activo marcado parcialmente al pasar el cursor por encima

indicadoral pasar el cursor

El indicador CheckDelegate se situó en torno al activo

ComboBoxfondo

Recurso de fondo para el cuadro combinado

fondodesactivado

Recurso de fondo desactivado del cuadro combinado

fondoen foco

Recurso de fondo del cuadro combinado al recibir el foco

fondoal pasar el cursor

Recurso de fondo del ComboBox al pasar el cursor por encima

fondopulsado

Recurso de fondo del cuadro combinado al pulsarlo

fondoabierto

Recurso de fondo de un cuadro combinado abierto

fondoeditable

Recurso editable de fondo para el cuadro combinado

fondoeditable, resaltado

Recurso de fondo del cuadro combinado editable y con el cursor sobre él

fondoeditable, desactivado

Recurso de fondo de un cuadro combinado desactivado y editable

indicador

Recurso del indicador ComboBox

indicadordesactivado

Activo desactivado en el indicador ComboBox

indicadoreditable

Activo editable del indicador ComboBox

indicadoreditable, desactivado

Indicador de ComboBox: activo desactivado y editable

indicadoreditable, reflejado

Activo editable de indicador ComboBox con efecto de espejo

indicadoreditable, reflejado, desactivado

Indicador de cuadro combinado, editable, reflejado, desactivado, activo

ventana emergente

Recurso de ventana emergente de ComboBox

DelayButtonfondo

Recurso de fondo del botón «DelayButton»

fondodesactivado

Recurso de fondo desactivado de «DelayButton»

fondodesactivado, marcado

Resource de fondo desactivado y marcado de «DelayButton»

fondoen foco

Recurso de fondo del botón «DelayButton» cuando está activo

fondopulsado

Recurso de fondo del botón «DelayButton» pulsado

fondomarcado

Recurso de fondo marcado de «DelayButton»

fondomarcado, enfocado

Botón de retraso: fondo, marcado, activo, enfocado

fondomarcado, al pasar el cursor

Recurso de fondo del botón «DelayButton» al pasar el cursor por encima

fondoal pasar el cursor por encima

Recurso de fondo del botón «DelayButton» al pasar el cursor por encima

progreso

Recurso de progreso «DelayButton»

progresodesactivado

Recurso «DelayButton» con progreso desactivado

máscara

Recurso de máscara «DelayButton»

Dialfondo

Recurso de fondo de la esfera

fondodesactivado

Recurso de fondo del dial desactivado

fondoen foco

Recurso centrado en el fondo de la esfera

control

Activo de la manivela del dial

controldesactivado

Activo con el tirador del dial desactivado

controlcon foco

Activo centrado en el mando de dial

controlcon el foco, pulsado

Activo presionado centrado en el mando del dial

controlenfoque, pasar el cursor por encima

Elemento en el que se centra el cursor al pasar por encima del dial

mangopulsado

Activo con maneta giratoria presionada

mangose ha pasado el cursor por encima

Activo en suspenso del mando del dial

Dialogfondo

Recurso de fondo del cuadro de diálogo

superposición

Recurso de superposición de diálogo

Véase la nota al pie 1
superposiciónmodal

Recurso modal de superposición de diálogo

Véase la nota al pie 1
DialogButtonBoxfondo

Recurso de fondo de DialogButtonBox

Drawerfondoizquierda

Recurso de fondo izquierdo del cajón

fondoderecha

Recurso de fondo del cajón derecho

fondoarriba

Recurso principal: fondo del cajón

fondoparte inferior

Recurso de fondo inferior del cajón

superposición

Recurso de superposición de cajones

Véase la nota al pie 1
superposiciónmodal

Recurso modal de superposición de cajones

Véase la nota al pie 1
Framefondo

Recurso de fondo del fotograma

GroupBoxfondo

Recurso de fondo de GroupBox

título

Recurso de título del GroupBox

ItemDelegateantecedentes

Recurso de fondo de ItemDelegate

fondodesactivado

Recurso de fondo desactivado de ItemDelegate

fondopulsado

Recurso de «pulsación de fondo» de ItemDelegate

fondoen foco

Recurso de ItemDelegate con fondo en primer plano

fondoal pasar el cursor

Recurso de fondo de ItemDelegate al pasar el cursor por encima

fondoresaltado

Recurso de ItemDelegate con fondo resaltado

Menufondo

Imagen de fondo del menú

MenuItemfondo

Recurso de fondo de MenuItem

fondodestacado

Recurso de fondo resaltado de «MenuItem»

flecha

Recurso de flecha de elemento de menú

flechareflejado

Recurso de flecha de MenuItem invertida

flechadesactivado

Recurso de flecha desactivada de MenuItem

flechareflejado, desactivado

Elemento de menú con flecha invertida desactivado (recurso)

indicador

Recurso indicador de elemento de menú

indicadordesactivado

Elemento de menú: indicador de activo desactivado

indicadorpulsado

Elemento del menú: activo pulsado

indicadormarcado

Elemento de menú: activo marcado

indicadormarcado, pulsado

Indicador de elemento de menú marcado, pulsado, activo

indicadormarcado, enfocado

Elemento de menú, indicador marcado, activo seleccionado

indicadormarcado, al pasar el cursor por encima

Elemento del menú: indicador marcado al pasar el cursor por encima del activo

indicadoren foco

Elemento del menú: activo destacado

indicadoral pasar el cursor

Elemento del menú: activo sobre el que se ha pasado el cursor

MenuSeparatorseparador

Elemento separador de menú

Pagefondo

Imagen de fondo de la página

Véase la nota al pie 1
PageIndicatordelegar

Recurso del delegado PageIndicator

delegardesactivado

Activo desactivado del delegado PageIndicator

delegadoinactivo, actual

Delegado de PageIndicator: activo actual desactivado

delegadopulsado

Activo pulsado del delegado PageIndicator

delegadoactual

Delegado de PageIndicator: activo actual

Paneantecedentes

Recurso de fondo del panel

Popupantecedentes

Recurso de fondo para ventanas emergentes

Véase la nota al pie 1
superposición

Recurso de superposición emergente

Véase la nota al pie 1
superposiciónmodal

Recurso modal de superposición emergente

ProgressBarfondo

Recurso de fondo para la barra de progreso

progreso

Recurso de progreso de ProgressBar

máscara

Recurso de máscara para la barra de progreso

RadioButtonindicador

Recurso de indicador de botón de opción

indicadordesactivado

Activo con indicador de RadioButton desactivado

indicadorpulsado

Elemento «RadioButton» activado

indicadormarcado

Activo con el indicador de botón de opción marcado

indicadormarcado, activo

Indicador de botón de opción marcado: elemento seleccionado

indicadormarcado, al pasar el cursor por encima

Elemento de radio con indicador marcado al pasar el cursor por encima

indicadormarcado, pulsado

Indicador de botón de opción marcado (pulsado)

indicadoren foco

Elemento de radio con indicador de selección

indicadoral pasar el cursor por encima

Elemento sobre el que se pasa el cursor del indicador de RadioButton

RadioDelegatefondo

Recurso de fondo de RadioDelegate

fondodesactivado

Recurso de fondo desactivado de RadioDelegate

fondopulsado

Recurso de RadioDelegate con fondo en relieve

antecedentescentrado

Recurso de RadioDelegate centrado en el fondo

fondoal pasar el cursor

Recurso de RadioDelegate con efecto al pasar el cursor por encima

indicador

Activo del indicador RadioDelegate

indicadordesactivado

Activo con el indicador RadioDelegate desactivado

indicadorpulsado

Activo seleccionado por el indicador RadioDelegate

indicadormarcado

Activo marcado por el indicador RadioDelegate

indicadormarcado, activo

El indicador «RadioDelegate» ha marcado el activo seleccionado

indicadormarcado, al pasar el cursor por encima

El indicador RadioDelegate ha marcado el activo al pasar el cursor por encima

indicadormarcado, pulsado

Indicador RadioDelegate: activo marcado

indicadoren foco

Activo en el que se centra el indicador RadioDelegate

indicadoral pasar el cursor por encima

El indicador RadioDelegate se situó en torno al activo

RangeSliderfondovertical

Recurso de fondo vertical para RangeSlider

fondohorizontal

Recurso de fondo horizontal para RangeSlider

progresovertical

Recurso de progreso vertical de RangeSlider

progresovertical, desactivado

Recurso de RangeSlider de progreso vertical desactivado

progresohorizontal

Recurso de progreso horizontal de RangeSlider

progresohorizontal, desactivado

Recurso de RangeSlider de progreso horizontal desactivado

control

Recurso del control deslizante de rango

controldesactivado

Elemento de control «RangeSlider» desactivado

controlcon el foco

Elemento en el que se centra el control RangeSlider

controlcon el foco, al pasar el cursor por encima

Elemento sobre el que se sitúa el cursor cuando el control RangeSlider tiene el foco

controlseleccionado, pulsado

Elemento con el foco en el control deslizante de rango pulsado

mangopasado el cursor por encima

Elemento sobre el que se pasa el cursor en el control deslizante de rango

manijapulsado

Recurso de control RangeSlider pulsado

RoundButtonfondo

Recurso de fondo «RoundButton»

fondodesactivado

Recurso de fondo desactivado de «RoundButton»

fondodesactivado, marcado

Recurso «RoundButton» con fondo, desactivado y marcado

fondoen foco

Recurso de fondo con botón redondo en estado de enfoque

fondopulsado

Recurso de fondo del botón redondo pulsado

fondomarcado

Recurso de fondo marcado de «RoundButton»

fondomarcado, enfocado

Recurso de botón redondo con fondo, marcado y resaltado

fondomarcado, al pasar el cursor por encima

Recurso de botón redondo con fondo, casilla marcada y efecto al pasar el cursor

fondoresaltado

Recurso de fondo resaltado de «RoundButton»

fondoresaltado, pulsado

Botón redondo con fondo resaltado al pulsarlo

fondoresaltado, enfocado

Botón redondo: fondo resaltado, elemento activo

fondoresaltado, al pasar el cursor por encima

Recurso de fondo resaltado al pasar el cursor sobre el botón redondo

fondoal pasar el cursor

Recurso de fondo de «RoundButton» al pasar el cursor por encima

ScrollBarcontrol

Recurso del control de la barra de desplazamiento

controldesactivado

Elemento desactivado de la barra de desplazamiento

controlinteractivo

Recurso interactivo del control de la barra de desplazamiento

controlinteractivo, desactivado

Elemento interactivo desactivado de la barra de desplazamiento

controlinteractivo, pulsado

Elemento interactivo «ScrollBar handle» al pulsarlo

controlinteractivo, al pasar el cursor por encima

Elemento interactivo al pasar el cursor por encima de la barra de desplazamiento

ScrollIndicatorcontrol

Gestión del recurso «ScrollIndicator»

Sliderfondovertical

Recurso de fondo vertical para el slider

fondohorizontal

Recurso de fondo horizontal para el control deslizante

progresovertical

Recurso de progreso vertical del control deslizante

progresovertical, desactivado

Elemento de progreso vertical desactivado del control deslizante

progresohorizontal

Elemento de progreso horizontal para el control deslizante

progresohorizontal, desactivado

Elemento de progreso horizontal desactivado

control

Recurso de control deslizante

controldesactivado

Recurso de control deslizante desactivado

controlcon el foco

Recurso centrado en el control deslizante

controlcon el foco, al pasar el cursor por encima

Elemento de interfaz que cambia al pasar el cursor sobre el control deslizante

controlseleccionado, pulsado

Recurso de imagen con el cursor sobre el tirador del control deslizante

mangopasado el cursor por encima

Recurso de desplazamiento al pasar el cursor por el control deslizante

manijapulsado

Recurso de control deslizante pulsado

SpinBoxfondo

Recurso de fondo de SpinBox

fondodesactivado

Recurso de fondo de SpinBox desactivado

fondoen foco

Recurso centrado en el fondo de SpinBox

fondoeditable

Recurso editable de fondo de SpinBox

indicadorarriba

Indicador SpinBox: activo al alza

indicadorarriba, desactivado

Indicador SpinBox: activo desactivado

indicadorarriba, pulsado

El indicador SpinBox muestra un activo al alza

indicadorarriba, con el foco

Activo en el que se centra el indicador SpinBox

indicadorarriba, reflejado

Indicador SpinBox: activo reflejado al alza

indicadorhacia arriba, con el cursor sobre él

El indicador SpinBox se situó por encima del activo al pasar el cursor por encima

indicadoractivo, editable

Indicador SpinBox: activo editable

indicadoractivo, editable, pulsado

Indicador SpinBox: activo editable al pulsar

indicadoractivo, editable, con el foco

Indicador SpinBox: activo destacado y editable

indicadoractivo, editable, reflejado

Indicador SpinBox: activo editable y reflejado

indicadoractivo, editable, al pasar el cursor por encima

Indicador SpinBox: activo editable al pasar el cursor por encima

indicadorabajo

Activo con indicador SpinBox a la baja

indicadorabajo, desactivado

Indicador SpinBox: activo desactivado

indicadorabajo, pulsado

Activo con el indicador SpinBox en posición baja

indicadorapagado, activo

Activo en el que se centra el indicador SpinBox

indicadorhacia abajo, reflejado

Indicador SpinBox: activo reflejado a la baja

indicadorhacia abajo, con el cursor sobre él

Activo sobre el que se sitúa el indicador SpinBox al pasar el cursor por encima

indicadorhacia abajo, editable

Indicador SpinBox: activo editable a la baja

indicadordesactivado, editable, pulsado

Indicador SpinBox: activo pulsado y editable hacia abajo

indicadoractivo, editable, seleccionado

Indicador SpinBox: activo en primer plano, editable, en descenso

indicadoractivo, editable, invertido

Activo de SpinBox en descenso, editable y reflejado

indicadorabajo, editable, al pasar el cursor por encima

Indicador SpinBox: activo editable al pasar el cursor por encima

SwipeDelegatefondo

Recurso de fondo de SwipeDelegate

fondodesactivado

Recurso de fondo desactivado de SwipeDelegate

fondopulsado

Recurso de fondo «pulsado» de SwipeDelegate

fondoen foco

Recurso de fondo de SwipeDelegate

fondoal pasar el cursor

Recurso de fondo de SwipeDelegate al pasar el cursor por encima

Switchindicador

Indicador de cambio de activo

indicadordesactivado

Indicador de activo desactivado

indicadorpulsado

Activo con indicador de conmutación pulsado

indicadormarcado

Indicador de cambio: activo comprobado

indicadormarcado, activo

Indicador de cambio: activo seleccionado comprobado

indicadormarcado, al pasar el cursor por encima

Indicador de cambio: activo marcado al pasar el cursor por encima

indicadormarcado, pulsado

Indicador de conmutador: activo comprobado y pulsado

indicadoren foco

Activo centrado en el indicador de conmutación

indicadoral pasar el cursor por encima

Indicador de cambio sobre el activo

control

Activo de la palanca de cambio

controldesactivado

Activo con el tirador del interruptor desactivado

controlpulsado

Activo con palanca de accionamiento presionada

SwitchDelegatefondo

Recurso de fondo de SwitchDelegate

fondodesactivado

Recurso de fondo desactivado de SwitchDelegate

fondopulsado

Recurso de fondo «pulsado» de SwitchDelegate

fondoen foco

Recurso de fondo con enfoque de SwitchDelegate

fondoal pasar el cursor

Recurso de fondo de SwitchDelegate al pasar el cursor por encima

indicador

Activo del indicador SwitchDelegate

indicadordesactivado

Activo con el indicador SwitchDelegate desactivado

indicadorpulsado

Activo seleccionado en el indicador SwitchDelegate

indicadormarcado

Activo marcado por el indicador SwitchDelegate

indicadormarcado, seleccionado

El indicador SwitchDelegate ha marcado el activo seleccionado

indicadormarcado, al pasar el cursor por encima

El indicador SwitchDelegate marca el activo sobre el que se pasa el cursor

indicadormarcado, pulsado

Indicador «SwitchDelegate»: activo seleccionado

indicadoren foco

Activo en el que se centra el indicador SwitchDelegate

indicadorse situó

El indicador SwitchDelegate se situó en torno al activo

control

SwitchDelegate gestiona el activo

controldesactivado

SwitchDelegate gestiona los activos desactivados

TabBarfondo

Recurso de fondo de la barra de pestañas

TabButtonfondo

Recurso de fondo de TabButton

fondodesactivado

Recurso de fondo del botón de pestaña desactivado

fondopulsado

Recurso de fondo del botón de pestaña pulsado

fondoa cuadros

Recurso de fondo marcado de TabButton

fondoal pasar el cursor por encima

Recurso de fondo del botón de pestaña al pasar el cursor por encima

fondodesactivado, marcado

Recurso de fondo de botón de pestaña desactivado y marcado

TextAreafondo

Recurso de fondo para TextArea

fondodesactivado

Recurso de fondo desactivado para TextArea

fondoen foco

Recurso de fondo para el campo de texto «TextArea» con foco

TextFieldfondo

Recurso de fondo de TextField

fondodesactivado

Recurso de fondo desactivado de TextField

fondoen foco

Recurso de fondo del campo de texto con foco

ToolBarfondo

Recurso de fondo de la barra de herramientas

ToolButtonfondo

Recurso de fondo de ToolButton

fondodesactivado, marcado

Botón de herramienta: fondo, desactivado, marcado, recurso

fondoen foco

Recurso de fondo del botón de herramienta con foco

fondopresionado

Recurso de fondo del botón de herramienta al pulsarlo

fondoa cuadros

Recurso de fondo marcado de ToolButton

fondomarcado, con el cursor sobre él

Botón de herramienta: fondo, marcado, enfocado, recurso

fondomarcado, al pasar el cursor por encima

Recurso de fondo, casilla marcada y efecto al pasar el cursor sobre el botón de herramienta

fondoal pasar el cursor

Recurso de fondo del botón de herramienta al pasar el cursor por encima

ToolSeparatorseparadorhorizontal

ToolSeparator: separador horizontal de activos

separadorvertical

ToolSeparator: separador vertical de activos

ToolTipfondo

Recurso de fondo para la información sobre herramientas

1 Una imagen de 1x1 que contiene un solo color, ampliada para ocupar todo el control.

Imágenes de 9-Patch

El estilo «Imagine» utiliza imágenes 9-patch para que los diseñadores puedan controlar cómo responde un elemento concreto al cambio de tamaño. A continuación se muestra un ejemplo de una imagen 9-patch que representa el background de un « Button », junto con una versión ampliada (para que se vean mejor las líneas del 9-patch):

Imagen de fondo de un botón de 9 partes que muestra las líneas de estiramiento y relleno

El contenido de la imagen mide 44 píxeles de ancho por 32 píxeles de alto. Cada imagen 9-patch necesita una línea de un píxel de grosor (denominadas colectivamente «líneas 9-patch») alrededor de cada lado, por lo que el tamaño real de la imagen pasa a ser de 46 píxeles de ancho por 34 píxeles de alto. Ten en cuenta que las líneas de 9-patch deben tener un grosor de un píxel, independientemente de los DPI de destino de la imagen. Por ejemplo, las líneas de 9-patch de «button-background.9.png» y «button-background@2x.9.png» deben tener ambas un grosor de un píxel.

Las líneas «9-patch» deben ser negras, y el resto de áreas deben ser transparentes o blancas:

Diagrama que muestra los requisitos de color de las líneas del «9-patch»

Áreas extensibles

Las líneas del 9-patch situadas en los bordes superior e izquierdo determinan qué partes de la imagen se estiran al cambiar su tamaño.

A continuación se muestran ejemplos de la imagen «9-patch» redimensionada a una vez y media su tamaño original en diversas dimensiones:

Ejemplos de imágenes de 9-patch redimensionadas en las que se aprecian las zonas elásticas

Fíjate en cómo las esquinas redondeadas conservan su tamaño original, ya que se encuentran fuera del ámbito de las líneas.

Áreas de relleno

Las líneas de 9-patch de los bordes derecho e inferior determinan cuánto espacio hay disponible para el « contentItem » del control, lo que significa que también se puede considerar que controlan el « padding ». Para ver un diagrama que ilustra el relleno, consulta Control Layout.

A continuación se muestran más ejemplos del cambio de tamaño de la imagen «9-patch», pero en esta ocasión se muestra cómo funcionan las líneas de relleno «9-patch».

Ejemplos de imágenes de 9-patch redimensionadas en las que se aprecian las áreas de relleno

El « contentItem » puede ocupar todo el espacio que necesite dentro de las áreas sombreadas. Si se omiten las líneas de relleno, el « contentItem » ocupará todo el espacio que necesite sin sobrepasar las áreas extensibles.

Áreas de inserción

En algunos casos es necesario que un control tenga, por ejemplo, una sombra proyectada. Sin embargo, si añadiéramos una sombra proyectada al botón anterior, esto afectaría a su tamaño, lo que plantea problemas tanto para el diseño como para los límites de entrada del ratón o táctiles.

Las áreas de recorte tienen esto en cuenta indicando al control que una determinada zona de la imagen 9-patch debe quedar fuera del control:

Diagrama en el que se muestran las líneas de inserción de 9 bloques para la sombra proyectada

En la imagen siguiente, la línea discontinua representa el área en la que se puede hacer clic en el botón, así como el espacio que ocupará en un diseño. La sombra queda marcada por el área rayada que hay detrás:

Botón con sombra proyectada que muestra el área en la que se puede hacer clic y los márgenes interiores

Exportación de imágenes 9-patch

Se pueden utilizar diversos editores vectoriales y de mapas de bits para crear imágenes 9-patch adecuadas para su uso con el estilo Imagine. En las siguientes secciones se explica brevemente el proceso de exportación para cada editor, y en la última sección se explica cómo asegurarse de que las imágenes exportadas cumplan con el formato 9-patch.

Affinity Designer

Consulta la documentación sobre los ajustes de exportación de Affinity.

Adobe Illustrator

Consulte la documentación de Adobe sobre el panel «Exportación de recursos ».

Adobe Photoshop

Consulte la documentación de Adobe sobre «Generar recursos de imagen a partir de capas ».

Inkscape

La extensión «Inkscape 9-Patch Export » permite exportar recursos con Inkscape.

Sketch

Consulta la documentación sobre exportación de Sketch.

Qt Quick Controls también ofrece un complemento para Sketch que corrige automáticamente el grosor de las líneas de los 9-patch tras la exportación de los recursos. Para instalar este archivo, haz doble clic en él. Una vez que Sketch haya confirmado que se ha instalado el complemento de exportación de 9-patch, este procesará automáticamente las imágenes al exportarlas.

Corrección de las líneas de 9-patch

Al exportar imágenes 9-patch en varias variantes de DPI (@2x, @3x, etc.), las líneas de 9-patch suelen ampliarse junto con la imagen. Hay varias formas de solucionar esto, pero quizá el método más sencillo sea utilizar la herramienta «mogrify» de ImageMagick. Esta herramienta cuenta con la función « -shave », que permite recortar la imagen para reducir el grosor de las líneas 9-patch:

mogrify -shave 1x1 -path path/to/images *@2x.9.png
mogrify -shave 2x2 -path path/to/images *@3x.9.png
mogrify -shave 3x3 -path path/to/images *@4x.9.png

Las imágenes con DPI normal (aquellas sin el prefijo « @Nx ») no se ven afectadas, por lo que solo es necesario ejecutar el comando en las imágenes destinadas a pantallas de alto DPI.

Imágenes animadas

El estilo «Imagine» es compatible con los formatos de imagen animada WebP y GIF.

Personalización

Ruta

El estilo «Imagine» permite personalizar la ruta que se utiliza para seleccionar los recursos de imagen. La ruta se puede especificar para cualquier ventana o elemento, y se aplica automáticamente a los elementos secundarios de la misma forma que fonts. En el siguiente ejemplo, la ventana y los tres botones de opción aparecen con recursos de imagen oscuros (archivos que se encuentran en «qrc:/themes/dark»).

import QtQuick
import QtQuick.Controls
import QtQuick.Controls.Imagine

ApplicationWindow {
    visible: true

    Imagine.path: "qrc:/themes/dark"

    Column {
        anchors.centerIn: parent

        RadioButton { text: qsTr("Small") }
        RadioButton { text: qsTr("Medium"); checked: true }
        RadioButton { text: qsTr("Large") }
    }
}

Botones de opción «Pequeño», «Mediano» y «Grande» en el tema oscuro de Imagine

Además de especificar la ruta en QML, también es posible indicarla mediante una variable de entorno o en un archivo de configuración. Los atributos especificados en QML tienen prioridad sobre todos los demás métodos.

Archivo de configuración
VariableDescripción
PathEspecifica la ruta al directorio que contiene los recursos de estilo de Imagine. Si no se especifica, se utilizan los recursos integrados.

Por ejemplo, para especificar una ruta a un directorio almacenado en el sistema de recursos:

[Imagine]
Path=:/imagine-assets

Para especificar una ruta relativa a un directorio local:

[Imagine]
Path=imagine-assets

Nota: Debido a una limitación técnica, la ruta no debe llamarse «imagine» si es relativa al archivo qtquickcontrols2.conf.

Consulte el archivo de configuración de controles deQt Quick para obtener más detalles sobre el archivo de configuración.

Variables de entorno
VariableDescripción
QT_QUICK_CONTROLS_IMAGINE_PATHEspecifica la ruta al directorio que contiene los recursos de estilo de Imagine. Si no se especifica, se utilizan los recursos integrados.

Por ejemplo, para especificar una ruta a un directorio almacenado en el sistema de recursos:

QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets

Para especificar una ruta relativa a un directorio local:

QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets

Nota: Debido a una limitación técnica, la ruta no debe llamarse «imagine» si es relativa al archivo qtquickcontrols2.conf.

QT_QUICK_CONTROLS_IMAGINE_SMOOTHEstablece el valor en 1 para habilitar el escalado fluido de las imágenes 9-patch. Esta variable de entorno se añadió en Qt 6.5.

Consulte «Variables de entorno compatibles» en «Controles de Qt Quick » para ver la lista completa de variables de entorno compatibles.

Paleta

El estilo «Imagine» permite personalizar la paleta mediante la propiedad « palette » y el archivo «qtquickcontrols2.conf ». Al igual que con otros estilos, los « palette roles » exactos que utiliza el estilo «Imagine» dependen del estilo. Sin embargo, dado que la mayor parte del aspecto visual de los controles (por ejemplo, los fondos) se gestiona a través de recursos de imagen, solo tendrán efecto los «roles» que se utilizan habitualmente para el texto.

Fuente

Las fuentes personalizadas se pueden configurar mediante la propiedad font y el archivo de configuración.

Dependencia

El estilo «Imagine» debe importarse por separado para poder acceder a los atributos específicos de dicho estilo. Cabe señalar que, independientemente de las referencias al estilo «Imagine», el mismo código de la aplicación se ejecuta con cualquier otro estilo. Los atributos específicos de «Imagine» solo surten efecto cuando la aplicación se ejecuta con el estilo «Imagine».

Si el estilo «Imagine» se importa en un archivo QML que se carga siempre, dicho estilo debe implementarse junto con la aplicación para poder ejecutarla independientemente del estilo con el que se ejecute. Mediante el uso de selectores de archivos, se pueden aplicar ajustes específicos del estilo sin crear una dependencia rígida con respecto a él.

Véase también: Estilización de los controles « Qt Quick »

Documentación sobre propiedades adjuntas

Imagine.path: cadena

Esta propiedad adjunta contiene la ruta de acceso a los recursos de imagen...

Button {
    Imagine.path: "qrc:/themes/dark"
}

© 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.