Sur cette page

QAxScriptEngine Class

La classe QAxScriptEngine fournit une interface autour d'un moteur de script. En savoir plus...

En-tête : #include <qaxscript.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS AxContainer)
target_link_libraries(mytarget PRIVATE Qt6::AxContainer)
qmake : QT += axcontainer
Hérite de : QAxObject

Types publics

enum State { Uninitialized, Initialized, Started, Connected, Disconnected, Closed }

Fonctions publiques

QAxScriptEngine(const QString &language, QAxScript *script)
virtual ~QAxScriptEngine() override
void addItem(const QString &name)
bool hasIntrospection() const
bool isValid() const
long queryInterface(const QUuid &uuid, void **iface) const
QString scriptLanguage() const
void setState(QAxScriptEngine::State st)
QAxScriptEngine::State state() const

Fonctions protégées réimplémentées

virtual bool initialize(IUnknown **ptr) override

Description détaillée

Chaque instance de la classe QAxScriptEngine représente un interpréteur de code de script dans un langage de script particulier. Cette classe n'est généralement pas utilisée directement. Les classes QAxScript et QAxScriptManager fournissent des fonctions pratiques pour gérer et appeler du code de script.

L'accès direct au moteur de script s'effectue via la méthode queryInterface().

Avertissement : cette classe n’est pas disponible avec le compilateur bcc5.5.

Voir également QAxScript, QAxScriptManager, QAxBase et le framework ActiveQt.

Documentation sur les types de membres

enum QAxScriptEngine::State

L'énumération « State » définit les différents états dans lesquels un moteur de script peut se trouver.

ConstanteValeurDescription
QAxScriptEngine::Uninitialized0Le script a été créé, mais n'a pas encore été initialisé
QAxScriptEngine::Initialized5Le script a été initialisé, mais n'est pas en cours d'exécution
QAxScriptEngine::Started1Le script peut exécuter du code, mais ne gère pas encore les événements
QAxScriptEngine::Connected2Le script peut exécuter du code et est connecté de manière à pouvoir gérer les événements
QAxScriptEngine::Disconnected3Le script est chargé, mais n'est pas connecté aux sources d'événements
QAxScriptEngine::Closed4Le script a été fermé.

Documentation des fonctions membres

QAxScriptEngine::QAxScriptEngine(const QString &language, QAxScript *script)

Crée un objet QAxScriptEngine chargé d'interpréter le code de script situé dans language, tel que spécifié par le code de script. Cette opération est généralement effectuée par la classe QAxScript lors de l'appel de loading a script.

Les instances de QAxScriptEngine doivent toujours disposer à la fois d’un langage et d’un script.

[override virtual noexcept] QAxScriptEngine::~QAxScriptEngine()

Détruit l'objet ` QAxScriptEngine `, libérant ainsi toutes les ressources allouées.

void QAxScriptEngine::addItem(const QString &name)

Enregistre un élément auprès du moteur de script. Le code de script peut faire référence à cet élément à l'aide de ` name`.

bool QAxScriptEngine::hasIntrospection() const

Renvoie « true » si le moteur de script prend en charge l'introspection ; sinon, renvoie « false ».

[override virtual protected] bool QAxScriptEngine::initialize(IUnknown **ptr)

Réimplémente : QAxBase::initialize(IUnknown **ptr).

bool QAxScriptEngine::isValid() const

Renvoie « true » si le moteur de script a été initialisé correctement ; sinon, renvoie « false ».

long QAxScriptEngine::queryInterface(const QUuid &uuid, void **iface) const

Demande l'interface uuid à l'objet moteur de script et attribue à la propriété iface la valeur de l'interface fournie, ou la valeur 0 si l'interface demandée n'a pas pu être fournie.

Renvoie le résultat de l’implémentation de la méthode QueryInterface de l’objet COM.

QString QAxScriptEngine::scriptLanguage() const

Renvoie le nom du langage de script, par exemple « VBScript » ou « JScript ».

void QAxScriptEngine::setState(QAxScriptEngine::State st)

Définit l'état du moteur de script sur « st ». Il n'est généralement pas nécessaire d'appeler cette fonction.

Voir aussi state().

QAxScriptEngine::State QAxScriptEngine::state() const

Renvoie l'état du moteur de script.

Voir aussi setState().

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