qt_policy

Modifier le comportement par défaut de l'API CMake de Qt.

La commande est définie dans le composant « Core » du paquet « Qt6 », qui peut être chargé comme suit :

find_package(Qt6 REQUIRED COMPONENTS Core)

Cette commande a été introduite dans Qt 6.5.

Syntaxe

qt_policy(
    [SET <policy_name> behavior]
    [GET <policy_name> <variable>]
)

Si les commandes sans version sont désactivées, utilisez plutôt qt6_policy(). Elle prend en charge le même ensemble d'arguments que cette commande.

Description

Cette commande dispose de deux modes :

• Lorsque le mot-clé « SET » est utilisé, cette commande permet d'activer les modifications de comportement dans l'API CMake de Qt, ou de les désactiver explicitement.
• Lorsque le mot-clé « GET » est utilisé, la variable « <variable> » est définie sur le comportement actuel de la politique, c'est-à-dire « OLD » ou « NEW ».

<policy_name> doit correspondre au nom de l’une des politiques CMake de Qt. Les noms de politiques se présentent sous la forme QTP<NNNN>, où <NNNN> est un entier indiquant l’index de la politique. L’utilisation d’un nom de politique non valide entraîne une erreur.

Le code prenant en charge des versions plus anciennes de Qt peut vérifier l’existence d’une politique en vérifiant la valeur de la variable QT_KNOWN_POLICY_<policy_name> avant de récupérer la valeur de <policy_name> ou de définir son comportement.

if(QT_KNOWN_POLICY_<policy_name>)
    qt_policy(SET <policy_name> NEW)
endif()

Vous pouvez définir behavior sur l'une des options suivantes :

• NEW pour activer le nouveau comportement
• OLD pour en exclure explicitement l’application

Politiques disponibles