Style universel

Le style universel s'appuie sur les directives de conception universelle de Microsoft. En savoir plus...

Propriétés associées

• accent: couleur
• arrière-plan: couleur
• premier plan: couleur
• thème: énumération

Méthodes associées

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

Description détaillée

Le style « Universal » est un style indépendant du périphérique, basé sur les directives de conception universelle de Microsoft. Il a été conçu pour s'afficher correctement sur tous les périphériques, des téléphones aux tablettes en passant par les PC.

Pour exécuter une application avec le style « Universal », consultez la section « Utilisation des styles » dans Qt Quick Controls.

Personnalisation

Le style « Universal » permet de personnaliser quatre attributs : le thème, la couleur d'accentuation, la couleur de premier plan et la couleur d'arrière-plan.

Ces deux attributs peuvent être définis pour n'importe quelle fenêtre ou n'importe quel élément, et ils se répercutent automatiquement sur les éléments enfants, de la même manière que l'fonts. Dans l'exemple suivant, la fenêtre et les trois boutons radio s'affichent avec le thème sombre et 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 dans QML, il est également possible de les définir via des variables d’environnement ou dans un fichier de configuration. Les attributs spécifiés dans QML ont priorité sur toutes les autres méthodes.

Fichier de configuration

Consultez le fichier de configuration «Qt Quick Controls » pour plus de détails sur ce fichier.

Variables d’environnement

Consultez la section « Variables d’environnement prises en charge » dans Qt Quick Controls pour obtenir la liste complète des variables d’environnement prises en charge.

Dépendance

Le style « Universal » doit être importé séparément pour pouvoir accéder aux attributs qui lui sont propres. Il convient de noter que, quelles que soient les 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 ce style.

Si le style « Universal » est importé dans un fichier QML qui est toujours chargé, il doit être déployé avec l’application afin de pouvoir exécuter celle-ci quel que soit le style utilisé. L’utilisation de sélecteurs de fichiers permet d’appliquer des ajustements spécifiques à un style sans créer de dépendance stricte vis-à-vis de ce dernier.

Couleurs « Universal » prédéfinies

Couleurs prédéfinies disponibles :

Voir aussi: Style de base, Style de matériau

Documentation sur les propriétés associées

Cette propriété associée contient la couleur d'accentuation du thème. Elle peut être associée à n'importe quelle fenêtre ou à n'importe quel élément. Sa valeur est transmise aux éléments enfants.

La valeur par défaut est Universal.Cobalt.

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

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

Cette propriété associée définit la couleur d'arrière-plan du thème. Elle peut être associée à n'importe quelle fenêtre ou élément. Sa valeur est transmise aux éléments enfants.

La valeur par défaut dépend du thème (clair ou foncé).

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

Pane {
    Universal.background: Universal.Steel

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

Cette propriété associée contient la couleur de premier plan du thème. Elle peut être associée à n'importe quelle fenêtre ou à n'importe quel élément. Sa valeur est répercutée sur les éléments enfants.

La valeur par défaut dépend du thème (clair ou foncé).

Dans l'exemple suivant, la couleur de premier plan du bouton est définie sur « Universal.Pink » :

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

Cette propriété attachée indique si le thème est clair ou foncé. Elle peut être attachée à n'importe quelle fenêtre ou à n'importe quel élément. La valeur est répercutée sur les éléments enfants.

Thèmes disponibles :

Si vous définissez le thème sur « System », le thème clair ou foncé est choisi en fonction des couleurs du thème système. Cependant, lorsque vous lisez la valeur de la propriété « theme », celle-ci n’est jamais « System », mais correspond au 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 ci-jointe

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

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

Informations connexes

• Mise en forme Qt Quick Controls