3.1 QtLua lua libraries

QtLua provides two sets of lua functions:

• A few general purpose global lua functions are provided. useful when running a lua script in the QtLua environment.

• A Qt library is provided which gives access to some Qt features which are not available from the Qt meta object system.

The QtLuaLib library contains the following lua functions:

• The print() lua function prints all passed values using the State::output signal.

• The list() lua function prints list of members of given table or global table if no argument is passed.

• The each() lua function returns a lua iterator which can be used to iterate over lua tables and QtLua UserData objects.

• The help() lua function can be used to display help about Function based objects:

  >> help(qt.connect)
usage: qt.connect(qobjectwrapper, "qt_signal_signature()", qobjectwrapper, "qt_slot_signature()")
qt.connect(qobjectwrapper, "qt_signal_signature()", lua_function)

• The plugin() function returns a Plugin object loaded from the given plugin bare file name.

• The qtype() function returns the lua type or userdata QtLua type name of a value.

The QtLib library contains some wrapped Qt functions and meta objects. Those are covered in this section.

The qt.meta table contains wrapped Qt meta objects, useful to access enums and other Qt meta data exposed by Qt.

This list can be extended by adding user defined QObject classes using the State::register_qobject_meta function.

The qt.new_qobject function creates a new QObject of given type. It relies on the qt.meta table provided by QtLua (see above):

Constructor arguments can be provided to use a constructors declared with the Qt Q_INVOKABLE attribute. Most Qt classes have constructors which can be called without argument and can thus be instantiated by this function without requiring the Q_INVOKABLE attribute.

The qt.connect function creates a connection between a Qt signal and a Qt slot or between a Qt signal and a lua function:

When a lua function is called from a Qt signal, its first argument is the sender object and next arguments are converted signal parameters (see Qt/Lua types conversion).

The qt.disconnect lua functions can be used to disconnect a Qt slot:

The qt.type function translate between a registered Qt type numeric handle and the associated Qt type name:

See also MetaType class.

The function creates a new widget of given type name using the QUiLoader::createWidget Qt function.

Use of the qt.new_qobject function is preferred.

The qt.load_ui function returns a Qt user interface file loaded using the QUiLoader::load Qt function:

The qtlua_uic tool can be used instead to compile a Qt .ui file to a lua scripts which creates the user interface.

The qt.layout_add function is able to bind QWidget objects to various kind of QLayout objects.

The qt.layout_spacer function adds a QSpacerItem object to a QLayout object.

The qt.ui.attach function invokes one of the following qt functions depending on passed QObject types: QMainWindow::setMenuBar, QMainWindow::setStatusBar, QMainWindow::addToolBar, QMainWindow::addDockWidget, QMainWindow::setCentralWidget, QDockWidget::setWidget, QStackedWidget::addWidget, QToolBar::addWidget, QScrollArea::setWidget, QSplitter::addWidget, QMdiArea::addSubWindow or QWorkspace::addWindow.

The qt.ui.menu.add_menu function creates and adds a new menu to a QMenu or QMenuBar object. The new QMenu object is returned.

The qt.ui.menu.add_separator function creates and adds a new separator to a QMenu or QToolBar.

The qt.ui.menu.add_action function creates and adds a new QAction to a QMenu, QMenuBar, QActionGroup or QToolBar.

The qt.ui.menu.new_action_group function creates a new QActionGroup and adds passed actions to it.

The qt.ui.menu.new_action function creates a new QAction object with specifed parent.

The qt.ui.menu.new_menu function creates a new QMenu object with specifed parent.

The qt.ui.menu.remove function remove a QAction or QMenu from a QWidget or QActionGroup. The default is to remove from the parent QObject.

These functions wrap various C++ static functions provided by Qt classes inheriting from the QDialog class. They are designed to request input from the user.

These functions wrap various C++ static functions provided by the QMessageBox class which open a pop-up message box.

These functions open an ItemViewDialog dialog which expose lua tables to the user using either TableTreeModel or TableGridModel.

This function returns a new TableTreeModel object which expose the specified lua table object. The new model can optionally be associated to some qt views.

This function returns a new TableGridModel object which expose the specified lua table object. The new model can optionally be associated to some qt views.

This function returns a new LuaModel object. At least one lua function is expected as argument in order to implement a read only model. The new model can optionally be associated to some qt views.

This function associates a model to one or more views.

This function returns a new ItemViewDialog object. The model and view objects to use must be passed to this function.

See also qt.dialog.*_view family of functions section, qt.dialog.*_view family of functions section and qt.dialog.*_view family of functions section.