Style universel

Le style universel est basé sur les directives de conception universelle de Microsoft. Plus d'informations...

Propriétés attachées

• accent: couleur
• background: couleur
• foreground: couleur
• theme: énumération

Méthodes attachées

• color color(énumération prédéfinie)

Description détaillée

Le style universel est un style indépendant de l'appareil, basé sur les directives de conception universelle de Microsoft. Le style universel a été conçu pour s'adapter à tous les appareils, qu'il s'agisse de téléphones, de tablettes ou d'ordinateurs.

Pour exécuter une application avec le style universel, voir Utilisation des styles dans les contrôles Qt Quick .

Personnalisation

Le style universel permet de personnaliser quatre attributs : le thème, l'accent, l'avant-plan et l'arrière-plan.

Ces deux attributs peuvent être spécifiés pour n'importe quelle fenêtre ou élément, et ils se propagent automatiquement aux enfants de la même manière que fonts. Dans l'exemple suivant, la fenêtre et les trois boutons radio apparaissent dans le thème sombre avec une couleur d'accent violette :

import QtQuick
import QtQuick.Controls
import QtQuick.Controls.Universal

ApplicationWindow {
    visible: true

    Universal.theme: Universal.Dark
    Universal.accent: Universal.Violet

    Column {
        anchors.centerIn: parent

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

Outre la spécification des attributs en QML, il est également possible de les spécifier via des variables d'environnement ou dans un fichier de configuration. Les attributs spécifiés en QML ont la priorité sur toutes les autres méthodes.

Fichier de configuration

Voir Qt Quick Fichier de configuration des contrôles pour plus de détails sur le fichier de configuration.

Variables d'environnement

Voir Variables d'environnement prises en charge dans Qt Quick Controls pour la liste complète des variables d'environnement prises en charge.

Dépendance

Le style Universal doit être importé séparément pour avoir accès aux attributs qui lui sont spécifiques. Il convient de noter qu'indépendamment des références au style Universal, le même code d'application s'exécute avec n'importe quel autre style. Les attributs spécifiques au style Universal n'ont d'effet que lorsque l'application est exécutée avec le style Universal.

Si le style Universal est importé dans un fichier QML qui est toujours chargé, le style Universal doit être déployé avec l'application afin de pouvoir exécuter l'application quel que soit le style utilisé. L'utilisation de sélecteurs de fichiers permet d'apporter des modifications spécifiques à un style sans créer de dépendance absolue à l'égard d'un style.

Couleurs universelles prédéfinies

Couleurs prédéfinies disponibles :

Voir aussi Style de base, Style matériel

Documentation sur les biens attachés

Cette propriété attachée contient la couleur d'accentuation du thème. La propriété peut être attachée à n'importe quelle fenêtre ou élément. La valeur est propagée aux enfants.

La valeur par défaut est Universal.Cobalt.

Dans l'exemple suivant, la couleur d'accentuation du bouton en surbrillance est modifiée en Universal.Orange:

Button {
    text: qsTr("Button")
    highlighted: true
    Universal.accent: Universal.Orange
}

Cette propriété jointe contient la couleur d'arrière-plan du thème. La propriété peut être attachée à n'importe quelle fenêtre ou élément. La valeur est propagée aux enfants.

La valeur par défaut est spécifique au thème (light ou dark).

Dans l'exemple suivant, la couleur d'arrière-plan du volet est modifiée en Universal.Steel:

Pane {
    Universal.background: Universal.Steel

    Button {
        text: qsTr("Button")
    }
}

Cette propriété jointe contient la couleur de premier plan du thème. La propriété peut être attachée à n'importe quelle fenêtre ou élément. La valeur est propagée aux enfants.

La valeur par défaut est spécifique au thème (light ou dark).

Dans l'exemple suivant, la couleur d'avant-plan du bouton est fixée à Universal.Pink:

Button {
    text: qsTr("Button")
    Universal.foreground: Universal.Pink
}

Cette propriété jointe indique si le thème est clair ou foncé. La propriété peut être attachée à n'importe quelle fenêtre ou élément. La valeur est propagée aux enfants.

Thèmes disponibles :

En attribuant la valeur System au thème, on choisit le thème clair ou foncé en fonction des couleurs du thème du système. Toutefois, lors de la lecture de la valeur de la propriété theme, la valeur n'est jamais System, mais le thème réel.

Dans l'exemple suivant, le thème du volet et du bouton est défini sur Universal.Dark:

Pane {
    Universal.theme: Universal.Dark

    Button {
        text: qsTr("Button")
    }
}

Documentation de la méthode attachée

Cette méthode annexe renvoie la valeur de la couleur effective de la couleur universelle prédéfinie spécifiée.

Rectangle {
    color: Universal.color(Universal.Red)
}

Informations connexes

• Stylisation des contrôles Qt Quick